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PREFACE 
to the Second Edition 



In the months since this .anual first appeared .any £■£«*— 
occurred both in the system itself and in the way i 

4- .w^uslv there have been additions, deletions, and 
Perhaps most obviously, tnere " ttV f It is these 

^Trt-SsT^^ *. ^P-ance of tM. r-U- 

manual . 

second, the number of ^^'''Tf^^ ^rSf'is £"£ ° f 

j*. f. ossanna for their contributions. 

Finally, the number of UN ? in -tjUation. has jro-^^wi^ 

more expected. None of these has ?t an v particular installation, 

hardware or software. ^Therefore at any part £ u £ iate 

it is quite Possible that this manual ^^ Jg ch * deal with 

information. One area to watc ^^^ r " Dlaces which talk about 
special files (I/O devices). Another is Pl^es w £^ 
such things as absolute oorelocat o « h ? r p ro ^ c tion 

hir^I.^so/nft^^ 

St.^^^ - anticipation of a 

UNIX for the PDP-11/45. 
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INTRODUCTION 



This ro anual gives descriptions oi | *• ^^1^^^ ™S" 
of UNIX. It Provides neith«ra^ener ^ implementatio n 

^l^JWEh r-fn at to bTdisclosed) . 

Within the area it surveys, this ^^^^iS™"--^ 
plete and timely as po ibU con it was in a t the time 

describe each program in exactl yt part icular t the desire to 
its manual section was preP 83 ^- - in * t as it is, was resisted, 
describe something as " "f^^^fwlll sion be out of 
inevitably, this means that J^J 5 ^^ is so great that a 
date. (The rate of dj»geofthe ^J^ns had to be modified 
dismayingly large number of earl Y sectio n effort quired 

while the rest were being ^ten^ T £* £ he f ^ tha t several of 

S/JSX^^ to aid in 

preparation of this manual!) 

-.-i 4 «. ^j^r-iripd into seven sections % 
This manual is diviaea i" LU 



I. 



Commands 

II. System calls 

III. Subroutines 

IV. Special files 
V File formats 

VI. User -maintained programs 

VII. Miscellaneous 



Commands are proofs intended to ^J^- ^Tar^in^ to 
user, in contradistinction to sut>ro ^*"_ • aen erally reside in 
tt called by the user s P^ams <*> ^ands ^neraliy ^ ^ 

directory /bin (for binary P ro ^f!^ e J^ter. Some programs 

Sulfas S^rS^^SSS-., tnis f-t is indi- 

cated in the appropriate sections. 

synonym for the tree instruction. 

S small assortment of subroutin - ^ aveilabl e^they^ are^ ^ 

described in section III. The binary r 

Kepfin the system library /usr/lib/liba.a. 

tu ^cmsses the characteristics of 
SSh'SSS ^lie- S whlcT ac!uaily U re? Irs to an x/0 device. 
The file formats section V documents the ^ -t- e^f f particular^ 

kinds of files; for ^"P^SJa £e files usedby only one com- 
and assembler i"^ ^ ?J intermediate files, 
mand, for example the assemoxei 
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user-maintained programs (••*«»*«,£ & fisting"^^ £ 
the OHM system, and the ^'"^"f™^,, giving a complete 
^^"P^ionf^fa^or ^be^Sted lor formation. 

The miscellaneous section (VII) gathers odds and ends. 

Each section consists of a number f.^f^^perVight 
page or so each. The name of «*; .^"^ * s * n t £e upper left. 

ISS.iiSl.'K'^S'S-S r cfi U^tnlfthe 

bered starting at page 1. 

All entries have a common format. 

The name section repeats the entry name and gives a very 

short~discription of its purpose. 

r^B^»-^--T-i^- ^"SSS^S? in the 

Commands section: 

Underlined words are considered literals, and are typed 
just as they appear. 

Square brackets ( [] ) around an argument Indicate that the 
Sgument is optional. When an argument is given as 
"name", it always refers to a file name. 

Ellipses -..." are used to .tow that the previous 
argument -prototype may be repeated. 

K final convention is used JV th^co-.*'.*^^^ 
An argument ^innxng wrth a ^J^^,,,, if it appears 
^ fpSsruirehrrfaluH^e^ould appear. Therefore, 
I? is unwise to have files whose names begin with 

The descriEtion section discusses in detail the subject at 

hand. 

The fUes section gives the names of files which are built 

into the program, 

A see also section gives pointers to related information. 

<,^4-*.™ rH seusses the diagnostics that may be 
^rSiidf^fnis^ecrioffenirto be as ?erse as the diagnos- 

tics themselves. 

The buas section gives known bugs a f *™f ^^clKeST 
ciesToccasionally also the suggested fix is describee. 
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4r 4-*i^<a n prson or persons "to 
Th e owner section gives the name of the per^ ^ ^ 
be coated in case of ««J££ t ^ ns it , so the owner is 
the last one to mod ifysom etni^g owner , s nickn ames stand 



not necessarily the author, 
for: 

ken K. Thompson 

dmr D. M. Ritchie 

ifo J. F. ossanna 

rhm R. Morris 

doug M. D. Mdlroy 

lem L. E. McMahon 

lie L. L. Cherry 

csr C S. Roberts 



These ni=Kn r s^ S hgpen ^^S^!' iftST 

«,* is a table of contents, organ- 
A t the beginning of * l « ^^"iJhin each section. There is 
? 7 ed bv section and alphabetically wi^n con tents. Within 

££ ^permuted index derived from t^tabl^of^ ^ 

each index entry, the title of tn * e ntheses This 

followed by the a PP r °P rl f*t?fit considerable name duplication 
fact is important *~"£J * h ~? n cJ P Sly from commands which exist 
among the actions, arising p rincip^ y 
only to exercise a particular sy* 

^•u« ttmty i-pvt editor ed and the 
This manual was prepared using the UNIX text __ 

formatting program roff . 
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initializer process 

init(VIl): initializer process 

instruction trap 

integer to ASCII 

integer 

interactively 

interpreter 

intrUl^catch or inhibit interrupts 
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bj(Vl): the game of black 

kbd(VIl): map of TTY 37 

:(l): place 

form(l): generate form 

lpr(IV): 

ld(l): 

link(Il): 

ln(l): 

ls(l): 
nlist(lll): read name 

dli(Vl): 

a.out(V): assembler and 

ld(l): link editor 

login(I): 

login(VIl): how to 

log (III): 

utmp( V ) : 



hog (II): set 



m6(l): 
mt(l): save/restore files on 

mtO ( IV ) : 
mail (I): send 



tap(l): 

man (I): run off 

uids(V): 

ascii(VIl): 

kbd(VIl): 



mem 



(IV): core 



mesg(l): permit or deny 

tss(I): communicate with 

msh(VIl): 

chmod(l): change access 

chmod(ll): change 

stty(Il): set 

stty(l): set typewriter 

gtty(Il): get typewriter 



istat(l): file status by i-n umber 
itoa(lll): convert integer to ASCII 

jack , * 

kbd(VIl): map of TTY 37 keyboard 

keyboard 

kill (II): destroy process 

label /, * \ 

ld(l): link editor (loader) 

letter 

line printer 

link editor (loader) 

link to file 

link to file 

link(ll): link to file 

list contents of directory 

list 

ln(l): link to file 

load DEC binary paper tapes 

loader output 

(loader) 

log on to system 

log onto system 

logarithm base e 

logged-in user information 

log (III): logarithm base e 

login(l): log on to system 

login(VIl): how to log onto system 

low-priority status 

lpr(IV): line printer 

ls(l): list contents of directory 

macro processor 

magtape 

magtape 

mail to another user 

mail(l): send mail to another user 

makdir(Il): create directory 

man(I): run off manual section 

manipulate DECtape 

manual section 

map names to user ID's 

map of ASCII 

map of TTY 37 keyboard 

mdate(ll): set date modified of file 

mem(lV): core memory 

memory 

mesg(l): permit or deny messages 

mesg(IIl): print string on typewriter 

messages 

MH-TSS (GCOS) 

mini Shell 

mkdir(l): create directory 

mode of files 

mode of file 

mode of typewriter 

modes 

mode 



- xvi - 



mdate(Il): set date 

moo(VI): the game of 

mount ( I ) : 

mount ( II ) : 



mv(l): 
seek(Il): 



nlist(III): read 

tty(l): find 

nm(l): print 

uids(V): map 

find (I): find file with given 

fork(Il): create 



od(l): 

man(l): run 

opr(l): print file 

login(VIl): how to log 

close(Il): close 

fstat(Il): status of 

open (II): 



cat( I) : concatenate 

assembler and loader 

ov(l): page 



chown(l): 
chown ( II ) : 



change 

change 

ov(l): 

type(l): print file 

dli(Vl): load DEC binary 

dpt(Vl): read DEC ASCII 

ppt(lV): punched 

passwd(V) 
mesg( I) 
ptx(Vl) 

:(D 
move read or write 
find read or write 



seek(II): 
tell(Il): 



chash(Vl) 

cal(Vl) 
echo( I) 



modified of file 

moo (VI): the game of MOO 

MOO 

mount detachable file system 

mount file system 

mount (I): mount detachable file system 

mount (II): mount file system 

move or rename file 

move read or write pointer 

msh(VIl): mini Shell „,„*.»„*, 

mt(l): save/restore files on magtape 

mtO(IV): magtape 

rav(l): move or rename file 

m6(l): macroprocessor 

name list 

name of terminal 

namelist t 

names to user ID s 

name 

new process , . . 

nlist(IIl): read name list 

nm(l): print namelist 

nroff(l): format text for printing 

octal dump of file 

od(l): octal dump of file 

off manual section 

off-line 

onto system 

open file 

open file 

open file 

open(H): open file 

opr(l): print file off-line 

(or print) files 

output.. .a.out(V): 

overlay file print 

ov(l): page overlay file print 

owner of files 

owner of file 

page overlay file print 

page-by-page 

paper tapes 

paper tapes 

paper tape 

passwd(V): password file 

password file 

permit or deny messages 

permuted index 

place label 

pointer 

pointer 

ppt(IV): punched paper tape 

prepare symbol table 

pr(l): print file with headings 

print calendar 

print command arguments 
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I 



nroff(l): 
roff (I): 
ov(l): 



opr(l): 

type(l): 

pr(l): 

cat( I) : concatenate (or 

nm( I ) : 
mesg(IIl): 
ptime(IIl): 
lpr(IV): line 
format text for 
. format text for 
page overlay file 
bproc(VIl): boot 
rele(Il): release 
fork(ll): create new 
init(VIl): initializer 
kill (II): destroy 
wait (II): wait for 
break(Il): set 
exec(Il): execute 
bc(Vl): compile B 
cc( I): compile C 
fc(l): compile Fortran 
tirg(Vl): compile tmgl 

ppt(lV): 



qsort(lll): 

quit( II) : catch or inhibit 
H dpt(Vl): 

read(Il): 
nlist(IIl): 
seek(ll): move 
tell (II): find 

rele(ll): 

strip(l): remove symbols, 

ttyO(lV): 

umount(l): dismount 

rmdir(l): 

rm(l): 

unlink (II): 

strip(l): 

mv(l) : move or 

salv(l): 

rew(l): 
rf ( IV ) : 

rkO(IV): 



print file off-line 
print file page-by-page 
print file with headings 
print) files 
print namelist 
print string on typewriter 
print time 
printer 
printing 
printing 
print 
procedure 
processor 
process 
process 
process 
process 
program break 
program file 
program 
program 
program 
progr am 

ptime(III): print time 
'ptx(Vl): permuted index 
punched paper tape 
putc(lll): write character 
qsort(IIl): quicker sort 

quicker sort 

quit(II): catch or inhibit quits 

quits 

read DEC ASCII paper tapes 

read file 

read name list 

read or write pointer 

read or write pointer 

read(Il): read file 

release processor 

rele(ll): release processor 

relocation bits 

remote typewriter 

removable file system 

remove (delete) directory 



or 



word 



file 
file 
relocation bits 



remove (delete) 

remove (delete) 

remove symbols, 

rename file 

repair damaged file system 

rew(l): rewind DECtape 

rewind DECtape 

RF disk 

rfO(IV): RF disk 

RK disk 

rk0(iv): RK disk 

rmdir(l): remove (delete) directory 

rm(l): remove (delete) file 
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sqrt(IIl): square 
rpO(IV): 

man (I): 



mt(-l): 

man(l): run off manual 



exit( I): 



mail (I): 

end command 

mdate(ll): 

hog(Il): 

stty(II): 

break(II): 

stime( II) : 

tabs(VIl): 

stty( I): 

setuid( II): 



msh(VIl)j mini 



fptr ap( III) : floating-point 

sin(IIl): 



sort(l): 

qsort(lll): quicker 

df(I): find free disk 

dpd(l): 



sqrt(lll): 



istat(l): file 

fstat(Il): 

hog(ll): set low-priority 

stat( I): get file 

stat(ll): get file 

tabs(VIl): set tab 

salloc(lll): 

mesg(lll): print 



sum( I): 

su(l): become 
basic(Vl): DEC 

chash(Vl): prepare 
db(l): 



roff(l)s format text for printing 

root 

RP disk 

rpO(IV): RP disk 

run off manual section 

sarioc(IIl): storage allocator 

salv(I); repair damaged file system 

save/restore files on magtape 

section 

seek(ll): move read or write pointer 

send mail to another user 

sequence 

set date modified of file 

set low-priority status 

set mode of typewriter 

set program break 

set system time 

set tab stops on typewriter 

set typewriter modes 

set user ID 

setuid(Il): set user ID 

Shell 

sh(l): command interpreter 

simulator 

sine, cosine 

sin(IIl): sine, cosine 

sleep(Il): delay execution 

sort ASCII file 

sort (I): sort ASCII file 

sort 

space 

spawn data-phone daemon 

sqrt(IIl): square root 

square root 

stat(l): get file status 

stat(Il): get file status 

status by i-nuraber 

status of open file 

status 

st at us 

status 

stime(ll): set system time 

stops on typewriter 

storage allocator 

string on typewriter 

strip(l): rerrove symbols, relocation bits 

stty(l): set typewriter modes 

stty(ll): set mode of typewriter 

su(l): become super-user 

sum file 

sum( I): sum file 

super-user 

supplied BASIC 

switch(lll): transfer depending on value 

symbol table 

symbolic debugger 
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strip(l): remove 

un(I): find undefined 

sync(Il): assure 

file systera(V): file 
stime(Il): set 
file 
check consistency of file 
login(l): log on to 
login(VIl): how to log onto 
mount detachable file 
mount (II): mount file 
salv(l): repair damaged file 
dismount removable file 
umount(ll): dismount file 
who(l): who is on the 
tabs(VIl): set 
chash(Vl): prepare symbol 
cref(Vl): cross-reference 

load DEC binary paper 

dpt(Vl): read DEC ASCII paper 

ppt( IV ) : punched paper 



symbols, relocation bits 

symbols 

synchronization . fc4 

sync(H): assure synchronization 

system format 

system time 

system(v): file system format 

system.. .check(l): 

system 

system 

system. . .mount (I): 

system 
system 
system.. .umount(I): 

system 
system 
tab stops on typewriter 

table 

tabs(VIl): set tab stops on typewriter 

tacct( I) : connect-time accounting 

tapes... dli(vi): 

tapes 

tape 

tap(l): manipulate DECtape 

tap(V): DECtape format 

tapO(IV): DECtape 



tty(l): find name of 
exit (II): 
ed(I): 
nroff(l): format 
roff(l): format 
ttt(Vl): the game of 
tm(I): get 
date(l): get date and 
time(Il): get 
ctime(IIl): convert 

ptime(IIl): print 

stime(Il): set system 

tmg(Vl): compile 



switch(IIl): 

goto ( I ) : command 

cemt(Il): catch EMT 

catch illegal instruction 

kbd(VIl): map of 



stty(l): set 



tell(H): find read or write pointer 

terminal 

terminate execution 

text editor 

text for printing 

text for printing 

tic-tac-toe 

time information 

time of day 

time of year 

time to ASCII 

time (II): get time of year 

time 

time 

tmgl program 

tmg(Vl): compile tmgl program 

tm(l): get time information 

transfer depending on value 

transfer 

traps 

trap...ilgins(II): r r m<i) 

tss(l): communicate with MH-TSS (GCOSj 

ttt(Vl): the game of tic-tac-toe 

TTY 37 keyboard 

tty(l): find name of terminal 

tty(IV): console typewriter 

ttyO(lV): remote typewriter 

type(l): print file page-by-page 

typewriter modes 
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gtty(Il): get 

getty(VIl): adapt to 

mesg(IIl): print string on 

stty(ll): set mode of 

tabs(VIl): set tab stops on 

tty(IV): console 

ttyO(IV): remote 



un(l): find 



du(l): find disk 

uids(V): map names to 

getuid(ll): get 

setuid(Il): set 

utmp(V): logged-in 

mail(l): send mail to another 

write(l): write to another 

transfer depending on 

ds(l): 
wait(H): 



who(l)s 

gerts(IIl): communicate 

find(l): find file 

pr(l): print file 

tss(l): communicate 

wc(l): get (English) 

putc(lll): write character or 

chdir(l): change 

chdir(Il): change 

putc(IIl): 

write(Il): 

seek(Il): move read or 

tell(H): find read or 

write(l): 



tirae(Il): get time of 
dnO ( IV ) : 
dpO ( IV ) : 
kbd(VIl): map of TTY 



typewriter mode 

typewriter 

typewriter 

typewriter 

typewriter 

typewriter 

typewriter Tr .'«» 

uids(V): map names to user IDs 

umount(l): dismount removable file system 

umount(ll): dismount file system 

undefined symbols 

un(l): find undefined symbols 

unlink(ll): remove (delete) file 

usage 

user ID's 

user ID 

user ID 

user information 

user 

user • . . 

utmp(V): logged-in user information 

value.. .switch(IIl): 

verify directory hierarchy 

wait for process 

wait(Il): wait for process 

wc(l): get (English) word count 

who is on the system 

who(l): who is on the system 

with GCOS 

with given name 

with headings 

with MH-TSS (GCOS) 

word count 

word 

working directory 

working directory 

write character or word 

write file 

write pointer 

write pointer 

write to another user 

write(l): write to another user 

write(Il): write file 

wtmp(V): accounting files 

year 

801 ACU 

201 Dataphone 

37 keyboard 
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NAME 

SYNOPSIS 

DESCRIPTION 



(I) 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



place a label 

[ label ] 

.v 4 ._ Tts only function is to place 

£E sheU does^Thave to be fixed to ignore 
lines with : 's. 

goto( I) 



dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 

BUGS 
OWNER 



ACCT (I) 

acct — login accounting 
acct [ wtrap ] 

«* Proves . printout I^^JglZ* 
total number of c °™ e ^| r °f the current wtmp 
i^ir TtttTVlt sauced. If no wt.p file 
is given, /tmo/wtmp is used. 

/tmp/wtmp 

mltfvll), tacct(I). login(I), «tmp(V). 

"cannot open '•t-p'" « "gument is unreadable. 



dmr, ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



F ILES 

SEE ALSO 

DIAGNOSTICS 



ar — archive 

ar key af ile name 1 ... 

Se m a^ive S f ?ir S ^ ma^usT^ci create S" 
Spaa?e libraryf lies as used by the loader It 
can be used, though, for any similar purpose. 

Key is one character from the »et £r£g|, option- 
ISly concatenated with y. afilj J"**® "2i ve 
?7io The names are constituent files in the 
"chive mtf^he meanings of the Kev characters 

are: 

d means delete the named files from the archive 

file. 

r means replace the named files in the archive 
file If the archive file does not exist, £ will 
create it. If the named files are not in the 
archive file, they are appended. 

t orints a table of contents of the archive file, 
-l/no names'are given, all files in the -chive 
are tabled. If names are given, only those files 
are tabled. 

u is similar to r except that only those files 
that have been modified are replaced. If no 
names are qiven, all files in the archive that 
Sfbeen modified will be replaced by the modi- 
fied version, 

x will extract the named files. If no nainesare 
oiven all files in the archive are extracted. 
In neither case does x alter the archive file. 

v means verbose. Under the verbose opt ion^ J| 
«<«m a file-bv-file description of the maK ln 9 or 
I nS archive file from the old archive and the 
consent fVles. The following abbreviations 
are used: 

c copy 
a append 
d delete 
r replace 
x extract 

/tmp/vtm? temporary 

ld(l), archive(V) 

- na( , US aae" "afile — not in archive format", 
"cannot open temj file", "name - cannot open , 
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BUGS 



OWNER 



AR (I) 



n v a<!P prror" "name — cannot create" A 
-STLSlSi «l?H S einnot create archive file . 
"name — not found . 

option vt should be implemented as a table with 
more information. 

There should be a way to specify the placement of 
a new file in an archive. Currently, it is 
placed at the end. 



ken, drar 
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NAME 

SYNOPSIS 

DESCRIPTION 



as — assembler 
as [ - ] name 1 .. . 

as assembles the concatenation of "f^i* •••* 
i£ based on the DEC-provided assembler PAL-11R 
tl] although it was coded locally. Therefore, 
only the differences will be recorded. 

If the optional first argument - is used, all 
undefined symbols in the assembly are treated 
global. 

Character changes are: 



as 



ed as 



or 


use 


@ 


* 


# 


$ 


• 
t 


/ 



in as, the character "; is a logical new line; 
sev'Sral operations may appear on one line it 
Ir^Pdbv ":-. Several new expression opera- 



separated by ; 

tors have been provided: 



\> 
\< 

* 

V 

% 

! 

JP 



right shift (logical) 

left shift 

multiplication 

division 

remainder (no longer means 

one's complement 

parentheses for grouping 

result has value of left, type of right 



"register" ) 



For example location (relocatable) can be writ- 
ten "0 . ; another way to denote register 2 is 
2 rO . 

All of the preceding operators are binary; if a 
left operand is missing, it is taken to be 
The "! operator adds its left operand to the 
one's complement of its right operand. 

There is a conditional assembly operation code 
different from that of PAL-11R (whose condition- 
als are not provided): 

.if expression 

lend if 

If the expression evaluates to non-zero^ the sec 
Jion of code between the .if and the .end if 
is assembled; otherwise it is ignored. .it 
may be nested. 
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lahpls like those introduced by Knuth 
Temporary labels liice \ n y labe l is de- 

[2] raay be employed. A temporary 



fined as follows: 
n: 



a^h- 9. Symbols of the form 

where n is a digit .. . *. X .. Uowing the 
"nf" refer to the first la J e J *i " nb " re fer 

use of the symbol; those^f the «^» B d many 
to the last jq: . The same £ ^ ^^ both 
iTlle i^fnatlon'of^^programmer and on the 
symbol table space of the assembler. 

•• ^ M M mi- M and " . end 

The PAL-11R opcodes .word , . eot 
are redundant and are omitted. 



The symbols 

"fr5 (floating-point registers) 



rO ... r5 

frO . 

sp 

pc 

ac 

mq 

div 

mul 

lsh 

ash 

nor 

csw 



ar e predefined with appropriate values The svm- 
bol E cs«- refers to the ~"^Ys a adeo to each 
reiocatahrrreference "fn^^^t^f- 

„«** "W is used to specify system 
The new opcode sys is U *J" * predefined. 

calls. Names for system calls are P r 

See section (II). 

Th e opcodes "hes" <f-* -^e^o'test llf 
ISoTsttrusTit set^n re'urf fro* svste* oalls. 

~e rhararters may be assembled in a way 
Strings of charact ers ™* * . « ascii " operation 
more convenient than PAL-11 s .ascii P 
(which is, therefore ?»£ted). S trin g 
included between the string quotes 

<here is a string> 
Escape sequences exist to enter non graphic and 
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AfVlW difficult characters. These sequences are 
quotes respectively. 



use for 

\ n newline (012) 

\0 NULL (000) 

\> > 

\t TAB (011) 

\a ACK (006) 

\r CR (015) 

\p ESC (033) 

\\ \ (134) 



as provides a primitive segmentation *■*=""*• 
fg£°ar. threS sjg-nt- iSg.^ andjs,. 
X. data s^mfnt ll provider initialized *- 
liable dSa. The bss »^ent c «not b ini 
tialized, but symbols may be defied to lie 
within this segment. In the f^ure 

text segment. The pseudo-operations 



.text 
.data 
.bss 



cause the assembler to switch to the text data, 
or bss segment respectively. Segmentation is 
useful afpresent for *» r.«Jon s: No n- 
initialized tables and variables, « P 
the bss segment, occupy no space in the % p 
file Also, alternative use of the t exc »" 
stents provides a primitive dual location- 
counter feature. 

*. *.«-i« ail fext-seament information 
I„ ^e output file all text seg^ ^ ±n£ 

Sfionfand' f SS^'inf ormatior J. ^^^ 
segment, information appears in the order writ 



ten. 



this segment is in the following style: 

.bss 

varl: . = .+2 

tabl: .=.+100. 

. • • 

is reserved but nothing explicit 



That is, space 
is placed in it. 
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As is evident from the example, n it *s legal J*> 
assign to the location counter . .„ It is also 
permissible in segments other than .bss .The 
Restriction is made, however, that the value so 
assigned must be defined in the first pass and it 
musJ be a value associated with the same segment 

as . • 

The pseudo-op 

.comm symbol, expression 

makes symbol an undefined global symbol, and • 
places the value of the expression in the value 
field of the symbol's definition. Thus the above 
declaration is equivalent to 

.globl symbol ^ 

symbol = expression symbol 

The treatment of such a symbol by the loader 
ld(l) is as follows: If another routine in the 
same load defines the symbol to" be an ordinary 
text, data, bss, or absolute symbol, that defini- 
tion takes precedence and the symbol acts like a 
normal undefined external. If however no other 
routine defines the symbol, the loader defines it 
as an external bss-segment symbol and reserves n 
bytes after its location, where n is the value of 
the expression in the .comm operation. Thus 
".comm x,100 M effectively declares x to be a com- 
mon region 100 bytes long. Note: all such de- 
clarations for the same symbol in various 
routines should request the same amount of space. 

The binary output of the assembler is placed on 
the file a.out" in the current directory, a^ut 
also contains the symbol table from the assembly 
and relocation bits. The output of the assembler 
is executable immediately if the assembly was 
error-free and if there were no unresolved exter- 
nal references. The link editor Id may be used 
to combine several assembly outputs and resolve 
global symbols. 

The assembler does not produce a listing of the 
source program. This is not a serious drawback; 
the debugger db discussed below is sufficiently 
powerful to r"ender a printed octal translation of 
the source unnecessary. 

On the last pages of this section is a list of . 
all the assembler's built-in symbols. In the 
case of instructions, the addressing modes are as 
follows: 
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FILES 



SEE ALSO 



DIAGNOSTICS 



BUGS 



src, dst 



fsrc,fdst 

fr 

exp 



AS (I) 



source, destination 

qeneral register 

floating source, destination 

floating register 

expression 



e pprfain 11/45 opcodes are different 
tions. 



/etc/as2 
/tmp/atm1? 
/tmp/atm2? 
/tmp/atm3? 
a .out 



pass 2 of the assembler 

temporary 

temporary 

temporary 

object 



ia(I ) ™,I, s,(I, un(X) f (I), Y-^lis.B- 
?"e5 S^. "e IL Si ffiinEater Progressing, 
vol. I; Fundamental Algorithms. 

When an input f Ue -ot be rea, ^^1?- 
lowed by ^ es s ^^ c ^c r seSntic errors occur, 
cea ! e8 :, ^a?acter diagnostic is typed out to- 

3 Ji2 S?h the line nLber and the file name in 
gether with the un 1 cause can - 

which it occurred Errors « J errors are: 

cell at ion of pass 2. The possxw. 



) 
] 
< 

• 

A 

B 

E 

F 

G 

I 

M 

O 

P 

R 

U 

X 



parentheses error 

parentheses error 

Itring not terminated properly 

indirection ( * ) used M illegally 

Illegal assignment to 

S^iniSESon i= «-« =r too remote 

frror £ %&?'*? or "b") type symbol 

Garbage (unknown) character 

End of file inside an Jf 

Multiply d efined . s y mb0 L a Ki G S at odd address 

SET. rrrorr^ailferentln'pass 1 ane 2 

Relocation error 
Undefined symbol 
syntax error 



Symbol table overflow is not checked. 



*t M 



OWNER 



If - - is moved backwards by an odd number of 
bytes, relocation bits are corrupted. 

dmr 
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Special variables: 



Register: 

rO 

r1 

r2 

r3 

r4 

r5 

sp 

pc 

frO 

fr1 

fr2 

fr3 

fr4 

fr5 

Eae & switches j 

csw 

div 

ac 

mq 

mul 

sc 

sr 

nor 

lsh 

ash 

System calls: 

exit 

fork 

read 

write 

open 

close 

wait 

creat 

link 

unl ink 

exec 

chdir 

time 

makdir 

chmod 

chown 

break 

stat 

seek 



tell 

mount 

umount 

setuid 

getuid 

stime 

quit 

intr 

fstat 

cemt 

mdate 

stty 

gtty 

ilgins 

hog 
Double operand: 



mov 

movb 

cmp 

cmpb 

bit 

bitb 

bic 

bicb 

bis 

bisb 

add 

sub 



Br anch: 



br 

bne 

beq 

bge 

bit 

bgt 

ble 

bpl 

bmi 

bhi 

bios 

bvc 

bvs 

bhis 

bee 

bec 

bio 

bes 

bes 



src A dst 



(= bec) 



(= bes) 
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Single operand; 



clr 

clrb 

com 

comb 

inc 

incb 

dec 

decb 

neg 

negb 

adc 

adcb 

sbc 

sbcb 

ror 

rorb 

rol 

rolb 

asr 

asrb 

asl 

aslb 

jmp 

swab 

tst 

tstb 



dst 



tstf 

movf 

raovf 

movif 

movf i 

movof 

movfo 

addf 

subf 

mulf 

divf 

cmpf 

roodf 



f src 
f src f f r 
fr,fdst 
src f fr 
fr,dst 
f src f fr 
fr f fdst 
fsrc,fr 
f src f fr 
fscr f fr 
f src f fr 
f src f f r 
f src f fr 



( = 
( = 
( = 
( = 
( = 
( = 



Idf ) 
stf ) 
Idcif ) 
stcfi) 
ldcdf ) 
stcfd) 



11/45 operations 



als 

alsc 

mpy 

dvd 

xor 

sxt 

mark 

sob 



src f r 

src f r 

src,r 

src f r 

src f r 

dst 

exp 

r f exp 



(= ash) 
(= ashc) 
(= mul) 
(= div) 



Specials 



src 
src 



Miscellaneous: 



jsr 
rts 
sys 



r f dst 

r 

exp 



(= trap) 



Fl ag-sett ing 5 



• byte 

.even 

• if 

• end if 
.globl 
. t ext 
.data 
.bss 
.co mm 



clc 
civ 
clz 
cln 
sec 
sev 
sez 
sen 



Floating point ops: 



cfcc 
setf 
setd 
seti 
setl 
clrf 
negf 
absf 



fdst 
fdst 
fdst 
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NAME bas — baSi ° 

SYNOPSIS b^s [ f ile ] 

before the console is read, 
bas accepts lines of the form: 

statement 
integer statement 



mt «,er numbered « a t r| nts (Known aj^nternal^ 
„„ b ered state^ent^are -edi.tel^execu^^ 

^at'does notlUr-"' as its highest operator) 

is printed. 

Statements have the following syntax: (ex^r is 

short for expression) 

6XP The expression is executed for its side 
effects (assignment or function call) or 
for printing as described above. 

done 

' Return to system level. 

for name = expr expr statement 
for name = expr expr 

• • • 

Tj^Tfor statement repetitively e* ecute f * 
statSint (first form) or a group of state- 
ments (second form) under cont ol of a 
named variable. The variable takes on tn 
value of the first expression, then is 
incremented by one on each loop, ™* *o 
exceed the value of the second expression. 

^heTxpression is evaluated truncated to 
an inteaer and execution goes to the 
oorresSSing integer numbered statment 

If executed from immediate mode the inter 
nal statements are compiled first. 

^ ?S r statem:nt nt is executed if the expression 
evaluates to non-zero. 

list [expr [expr]] 
_ 1 - 
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11* i. «•« f 'UVS^In^ £ g^enT 

nal statements. It no cixy^ . ._ ~a -rf 
Sn internal s» = t B are print -.^ 

one argument is f^ en - ° n ^ , rg „ e „ts are 
T^TXnl^lt- statements Ijd-.lv.ly 
betw^n the arguments are printed. 



The express 



raluated and printed, 



^Sa-SS 2 S^Sue ofV5?unct^ 



call* 



EHB ' h Vf faSl" 1 . fs a re-lni?iali,ea: Pi T?t- raX 
symbol table is re xnx control is 

£55 'to^nf lowelt^red^nternai 

statement • 
Expressions have the following syntax; 



name 



t name is used to spec "y^^l'l •,•) 
Names are composed of a letter I a 

four°^^^ 

"^number is used to represent a constant 

vaxue. A number is composed °* d ^* k f a 
nost one decimal point ( .. ) »JJ ^J 8 ^ Y 
scale factor of the form e digits or e_ 

digits. 

1 ^rentheses are used to alter normal order 
of evaluation. 

expr op e *Pf f two arguments are ab- 

pletllist of operators is given below. 

expr i texpr U expr. ..]] 1 _ 

Sfcan bl raued'^an expression fol- 
ded by the arguments in P-ent^eses 
^S^lST^^- entry of tbe 
Munition in the internally ££-.£££,*. 
ments. This causes the internax 



ment s . 
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to be compiled. If the ^ression evalu- 
»* ec operative, a built in function is 
called The list of builtin functions 
appears below. 

name [ expr U expr ...3 1 

Arrays are not yet implemented. 

The following is the list of operators: 

= is the assignment operator. The left 
operand must be a name or an a f a * f^ nt * 
tE* result is the right operand. Assign- 
ment binds right to left, all other opera- 
tors bind left to right. 

& ' & (logical and) has result zero if either 
of its arguments are zero. It has result 
one if both" its arguments are non-zero x 
Mooical or) has result zero if both of its 
argument are zero. It has result one if 
either of its arguments are non-zero. 

< ^he relational operators (< less than, <= 
less than or equal, > greater than, >- 

Jf the specified relation. They return 
zero otherwise. Relational °P erato ^ ** 
?he same level extend as follows: a>b>c is 
the same as a>b&b>c. 

+ — 

Add and subtract. 

* / 

Multiply and divide. 

Exponentiation. v 

The following is a list of builtin functions: 

ar9 ^rrM^ is the value of the ith actual 

fa?ameter on the current level of function 



P 
call. 



exp 



Exp(x) is the exponential function of x. 
Log I 



109 (x) is the logarithm base e of x. 
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FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



sin 



cos 



atn 



Sin(x) is the sine of x (radians). 
Cos(x) is the cosine of x (radians). 



Atn(x) is the arctangent of x. (Not topi- 
ment ed # ) 



rnd 



Rnd( ) is a uniformly distributed random 
number between zero and one. 



expr 



Ltn expression. The resultant value i. 

returned. 



int lnt(x) returns x truncated to an integer, 
/tmp/btm? temporary 

[1] DEC-11-AJPB-D 

SlthefaragnfsScs are self explanatory. 

n ar-o not vet implemented. In general, 
^fJslfes.Tecursion? etc are net cheOceo, 
and cause trouble. 

ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



cat — concatenate and print 



cat f ile-j • • • 

cat reads each file in sequence and writes it on 

fft standard output stream. Thus. 

cat file 
i. aoout «.. easiest way to print a f 11.. Also: 

cat filel lilSZ KiiSl 
i. about the easiest way to concatenate files. 
If no input file is 9 iven cat reads fro B «,. 
standard input file. 



pr(l), cp(l) 



non 



e; if a f 



ile cannot be found it is ignored. 



ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 



SEE ALSO 
DIAGNOSTICS 

BUGS 
OWNER 



cc c compiler 



stiles 



ofile. 



It accepts three 



cc [ r£ 3 

cc is the UNIX C compiler, 
types of arguments: 

A t .<4-v " c " are assumed 
Arguments whose names end wit Yi . and 

to be C source P ro *r^s, Jney ar v gflle 

the object Program is left on the ti ^^ 

#i e the file whose name^is tnat 
with*".©" substituted for .c ). 

, ~o~+ for n -c") are assumed to 
Other arguments ( J*"?* for s , or C-compatible 
be either loader ^^^produced by an earlier 
object programs, ^i^ly P™ c _ compa tible 
cc run, or perhaps paries or * the 

Routines. These programs, to 9^n .. are loaded 
results of any corn Pf^^ du ?r an executable 
(in the order given) to produce an 
program with name a f ou t. 

being compiled. 



file.c 

a. out 

c.tmp 

/sys/c/nc 

/usr/lib/crtO.o 

/usr/lib/libc.a 

/usr/lib/liba.a 



input file 

loaded output 

temporary (deleted) 

compiler 

runtime startoff 

built in functions, etc. 

system library 



C reference manual (in preparation), bc(VI) 
Diagnostics are intended to be self-explanatory. 



dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 

BUGS 
OWNER 



chdir 



change working directory 



chdir directory 

v~™nM the new working directory. 
fli rectory becomes tne new 

i« ^rpai-ed to execute each 
Because a new P roc *f ** "?fective if it were 
command, chdir "^ld be inef feet i fore 

written as a normal « f; X h n , 
recognized and executed by the sn x 



sh(l) 

" B ad directory 
changed to. 



ken, dmr 



" if the directory cannot be 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



BUGS 



OWNER 



CHECK (I) 



check — file system consistency check 
check [ filesystem [ blockno., ... ] 3 

check will examine a file system build a bit map 
ofufed blocks, and compare this bit map against 
?he bit map maintained on the file system. If 
the file system is not specified, a check of all 
It the normally mounted file systems i« P£; 
formed. Output includes the ;™*2_ ? "^ 
the file system, the number of these that are 
'large', the number of used blocks, and the 
number of free blocks. 

/dev/rf ?, /dev/rk?, /dev/rp? 

find(l), ds(l) 

,.•„,. =>r-o nmfluced for blocks missing, 
Seated and fad bile* addresses. Diagnostics 
Ir? also produced for blocK numbers passed as 
rJ^rf. in eacb case f e ^* «^« ir « t , 
i-n umber, and block class ^i U1UU » - 
f free) is printed. 

The checking process is two pass * n "J^% x * f 
checking is done on an active file system, 
traneous diagnostics may occur. 

Tbe swap space on the RF file system is not ac- 
counted P fo? and will therefore show up as miss- 
ing', 
ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



CHMOD (I) 



chmod — change mode 
chmod octal file 1 . *. 

the following modes: 

01 write for non-owner 

02 read for non-owner 
04 write for owner 

10 read for owner 
20 executable 
40 set-UID 

only the owner of a file may change its mode. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



stat(l), ls(D 



ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



CHOWN (I) 



chown — change owner 

chown owner f ile 1 . . . 

^^ ~* -t-v>a files. The 
2^ beco.es the new «££*,«; or . nam e found 
owner may be eitner a « 
in /etc/uids. 

* a -File is allowed to change the 

S^'iH""^ "« >«*•»>• the OMner of a 

lufiith the set-user-ID «xJ«. 
/etc/uids 

W if oune r cannot be found, "filet" if «U- 
cannot be found. 



BUGS 
OWNER 



ken, dmr 



- 1 - 



3/15/72 

NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



CMP (I) 



cmp 



compare two files 



cmp file 1 f ile 2 

The two files are compared for identical con- 
tents! Discrepancies are noted by giving the 
offset and the differing words. 



incorrect usage. 

Tf the two files differ in length by one byte 
the e^byte does not enter into the comparx- 

son. 
dmr 
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CP (I) 



NAME 

SYNOPSIS 

DESCRIPTION 



C p — copy 

C£ f ile 1 fil e 2 

the second. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



OWNER 



cat(l), pr(l) 

Th e second file should be created in the m0 de of 
the first. 

ut^rs ac used in niv should be 
A directory convention as used in m_ 

adopted for cp. 
ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



DATE (I) 



date — print and set the date 

date [ mmddhhmm ] 

If no argent is *iv«. th^carr^at. is 

f^r^z ™? s i^m r*& =-<*• — 

For example: 

date 10080045 
sets the date to Oct 8, 12:45 AM. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



if the argument is syntactically incorrect, 



dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



DB (I) 



Sb — debug 

db [ core [ namelist ] ] [ r 3 

Unll Ke many -•^^^^S.iS^S'nSf '" d 
ODT, on ^ich d|ia loosely ^-^ lt d 

loaded as part °^J?t examines files. Typical- 
to examine; i^eadit exam in e pro duced 

ly. ^e file will be either a^c ^ 88 

after a fault °f J*J.?^ n Cl nq debugged; if omit- 
bler. Core is the file being de ugg .^ con _ 

ted "coTT-is assumed SSffiSUS| B ^tei, the 

taining a^ 1 .^ f r0 m the file being 

^r?i «- , Kt iS. f S'i« syndic facilities 
become unavailable. 

nfrte oDtional third argument, 
For the meaning of the ?P«£ na 
see the last paragraph below. 

Mar—. «• expressions built up as follows: 
,.»»«. has the value assigned to it*- 

SScSSSi.^ =5 S^SE- *- use - 

the name during the assembly. 

propriate value. 

- S£.3?5 £ 1 Si a 25^3S2 t i. set 

by many db requests. 

4- * fcv "+" or " " (blank) 
5. Expressions separa Jf 1 g fco fche sum 

are expressions wi th value q Qf ^ com _ 
of the components.. At mo 
ponents may be relocatable. 

,^1-^ri bv "-" form an ex- 
- -f» ue e f |l e to the «£r- ? 

£ felocaSrtne feft cogent .ust be 

relocatable. 

, flrq are evaluated left to right. 
7. Expressions are cvcij. 
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DB (I) 



Names for registers are built in: 

rO ... r5 

sp 
pc 
ac 
mq 

These may be examined. Their values are deduced 
f rem ^contents of the stack in a core ^ age 
file. They are meaningless in a file that is not 
a core image. 

If no address is given for a command, fc *;* cur f? nt 
address (also specified by . ) is assumed. In 
general, ." points to the last word or byte 
printed by db. 

There are db commands for examining locations 
Interpre?ed-as octal numbers, machine xnstruc- 
i?««« ASCII characters, and addresses. For 

Ss characters,' either bytes or words may 
^examined. The following commands are used to 
examine the specified file. 

/ The addressed word is printed in octal. 

\ The addressed byte is printed in octal. 

" The addressed word is printed as two ASCII 
characters. 

' The addressed byte is printed as an ASCII 
character. 

» The addressed word is multiplied by 2, then 
printed in octal (used with B programs, 
whose addresses are word addresses). 

? The addressed word is int erpreted as a of 
machine instruction and a symbolic form of 
the instruction, including symbolic ad 
dresses, is printed. Often, the result 
will appear exactly as it was written in 
the source program. 

& The addressed word is interpreted as a sym- 
bolic address and is printed as the name of 
the symbol whose value is closest to the 
addressed word, possibly followed by a 
signed offset. 

/ nl \ (i. e .. the character "new line") This 
<nl co^;nd dvances the current location 

counter . and prints the resulting loca 
Soffn the mode last specified by one of 
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the above requests. 

~ This character decrements "." and Points 
the resulting location in the mode last 
selected one of the above requests. It is 
a converse to <nl>. 

% Exit. 
It is illegal *« ^^rlen^c-^^ 
haV ?,^ d c? dSrS "on; bylhe <S and 3 requests is 
^"on^oftwo adding « ?^~ * e last com ' 
mand was word or byte oriented. 

The address portion of any ^.f^expres- 

T bS ^'tMs'case^nrnuSber o?" sequential 
sion. In this case ^ expression is 

TAtUi: ^^s^anced^thaf !t points at 
the last thing printed. 

There are two commands to interpret the value of 
expressions • 

. When preceded by an express £n. £e value^ 
of the expression is typed in o^al. 

« frifdfca^ STcSSi-^ not 

change the value of . . 
, An attempt is made to print the given^x- 
pression as a symbolic address. * 
expression is relocat able th a t symb ol^ 
found whose value is ^^^J"*-,, fo i- 
expression, and the ^* £ p 2g£' offset. 

value of the expression is given. 

The following command may he used to patoh the 

file being debugged. 

r Thi s command must be preceded by an^^pres- 
sion. The value of »e expre 
stored at the location £f;«~ e8 y do not 
current value of • • i?P so the user 
-rassemSe 3SVS£ 

The following commanc j 1. -d af^fault has 
caused a core image file t° oe y 
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DB' (I) 



FILES 



$ causes the fault type and the contents of 
the general registers and several other 
registers to be printed both in octal and 
symbolic format. The values are as they 
were at the time of the fault. 

Db should not be used to examine fecial files^ 
for example disks and tapes, since it reads one 
byte at a time. Use od(l) instead. 

For some purposes, it is important to know how 
addresses typed by the user correspond with loca 
tionsin the file being debugged. The mapping 
aigorithm'employed by db is non-trivial for two 
reasons: First, in an a. out file, there is a 
20(8) byte header which will not appear when the 
file is loaded into core for execution. There 
lilt Lnarent location should correspond with 
actual f Ue off set 20. Second, some systems 

wmmmms 

If exactly one argument is ^'.^/^Lr^s 
pears to be an a. out file, the 2D eyte n 
skipped during addressing, i.e., 20 is added to 
*11 addresses typed. As a consequence, the 
header can oe examined beginning at location -20. 

Tf exactlv one argument is given and if the file 
doefnot appear tcTbe an euout file, no mapping 
is done. 
If zero or two arguments are given, the mapping 

**t-a keot bv the system, which is storea i" "' 
memory file /dev/mem. 
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SKEALSO M (I). COT.(V). ..oottv). <-(!) 

WM .OBTICS "File not W.if th. fir-: ardent cannot 

UXA read; otherwise ? . 

Th e ~" request always decrements "." by 2, even 
BUGS in byte mode. 

OWNER dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



ac — desk calculator 



dc 



dc is an arbitrary precision integer arithmetic 
^ackaqe. The overall structure of dc is a stack- 
ing (reverse Polish) calculator. The following 
constructions are recognized by the calculator: 

nUm The value of the number is pushed on the 

stack. If the number starts with a zero, it 
is taken to be octal, otherwise it is decimal. 

1 "The top two values on the stack are added (+), 
subtracted (-), multiplied (•), divided (/), 
or remaindered (%). The two entries are 
poppped off of the stack, the result is pushed 
on the stack in their place. 



sx 



lx 



The top of the stack is pooped and stored into 
a register named x, where x may be any charac- 
ter. 

The value in register x is pushed on the 
stack. The register x is not altered. 



" The too value on the stack is pushed on the 
stack. Thus the top value is duplicated. 

2 The top value on the stack is printed in de- 
cimal. The top value remains unchanged. 

" All values on the stack are popped off and 
printed in decimal. 



exits the program 

25 treats the top element of the stack as a char- 
acter string and executes it as a string of dc 
commands 

1 interprets the rest of the line as a UNIX com- 
mand. 

£ All values on the stack are popped. 
- 1 - 
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nk 



A scale factor of 1 n is set for all subse- 
quent multiplication and division. 



new-line 
space 

ignored, 

A„ examole to calculate the mon thly, weekly and 
hourly rates for a s10,000/year salary. 



10000 

100« 

dsa 

12/ 

la52/ 

dlO* 

375/ 

f 

(3) 512 
(2) 19230 
(1) 83333 



(now in cents) 
(non-destructive store) 
(pennies per month) 
(pennies per week) 
(deci-pennies per week) 
(pennies per hour) 
(print all results) 



FILES 

SEE ALSO 

DIAGNOSTICS 



BUGS 
OWNER 



(x) ? for unrecognized character x. 

(x) -> for not enough elements on the stack to do 

"out cTspace^when the free list is exhausted. 

f is not implemented 
% is not implemented 

rhm 



- 2 - 



3/15/72 

NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



DF (I) 



df — disk free 
df [ filesystein ] 

g rss: °£-: -?s.iir.-^sr;. »ss= 

Si-, thl free space on all of the normally 
mounted file systems is printed. 

/dev/rf?, /dev/rk? f /dev/rp? 
check (I) 



ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



DPD (I) 



dpd — spawn data phone daemon 
/etc/dpd 

the gerts interface. 

apd uses the ^ir-tory/^r^. The file ig^ s 
iKhat directory is used to prevent^ ^ ^ 
from becoming active. Alter tn main 

cessfully set the lock, it f° r *J ** /usr/dpd 

nath exits, thus spawning the daemon. jj± — *-^tr h 
path exits, w anv Tf tie beginning with df . Eacn 
1^^^^!^ sfJt^a a S 1 Jf , S line of a 

^"y"-^"-^^^^- of the Un. 

S directs apd tc .J. -rate J-^^^* 
This card is gener ated b y in con _ 

eSlnTS.? £ to h ae f oiial Z col^n^d-«ith the 
station ID. 

!, specific that the remainder of the line is 
to be sent as a literal. 

• «4 Ae -n-haf the rest of the line is a 
!iirn^e? S That at file I. to be sent as binary 

cards. 

F i. the sa»e as E except the file is prepend- 

"id with a form feed. 

ted, the file is unlinked. 

*-^~* u-ni cause the daemon to 
Any error en f> unt ^"£r 2 minutes and start 
drop the call, wait up. to 20 »« con structed 

over. This means ^hat an improp y submitte d 
df file may cause the same job to 
every 20 minutes. 

^^^iil^r-xf fhe^H ^the 
daemon will exit. 



/dev/dnO, /dev/dpO, /usr/dpd/* 



opr(l) 
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OWNER ken 



^1 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUSS 



OWNER 



DS (I) 

ds __ directory consistency check 
ds [ output ] 

Keeping a list of "£** * ".list and compare the 
Ser ir inKs\nere with the actual numher 
rW. All discrepancies are noted. 

/, /dev/rkO, /tmp/dstrap 

check(l) 

inconsistent i-numbers 

the root is noted « J"™^^ ^Ti^Ir' If 
that / exists in no directory, v ^ 

L' should taXe an alternate file system argument. 

ken 



■^:u. 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



dsw 



__ delete interactively 



dsw [ directory ] 

For each file in the ? iv«n directo ry J."." if^ot 

Srffif ^lefedt ^"^Ve/ts/if Any- 
thing else, the file is not removed. 



rra(l) 



The name dsw 



is a carryover from the ancient 
.._. ,_ tm„«H«cr i^ut the name ii 



past. Its etymology is amusing but the 
nonetheless ill-advised. 

dmr, Ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



DU (I) 



du __ summarize disk usage 
du [^s ] C =S 3 [ name ... ] 

specified directory or file name. x _ 

missing, A is used. 

^e optional ar gument ? cjuj es on l^f^ 
total to be given. The optiona i g f __ e> 

causes an entry to be g«« a "J J be generated 

Absence of either causes an entry 9 

for each directory only. 

A f U e which has two linKs to it is oniy counted 

once. 



OWNER 



Kon-dlrectories ,lv« - arguments (not under -a 
option) are not listed. 

Removable file systems do «* "J*^^ 1 * 
since i-n-b-..y £ 'g-trf-hl^ stould 

ssss^^S' »* p« «-* airectory 

encountered, 
dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



echo echo arguments 

echo [ arg^ • • • J 

echo writes 11 it. «*-•?■ £ ?f ^nlyVs^ui 
-^Tthe standard output file, xt i 



on th 
for 



^oTucinraiagnostics in coMaan* files. 



doug 
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NAME 
SYNOPSIS 

DESCRIPTION 



ed 



editor 



ed [ name ] 

ed is the standard text editor. 

If the optional -^/^e^haf ifto'fay! 
an e command °* the named *«j£ * h it can 
the file is read into ed s burrer 
be edited. 

,, operates Vt ~P^ ^% l£ eor S l tff ' 
S^u^ln 1 ^ c f Lite (H U o ri na al S esiaes 

tiTi-S^iS caUefthe iJlK- «»« " 

only one buffer. 

Commands to ed have a si ^J^/SSSed by a 
structures zero or roo ^,^||fff Y followed by 
single character comma^, P°^ e y addresse s 
parameters to ^e command. These Every 
specify one or ^r lines in ^ de 
command which requires can often be 

addresses, so tnat me 
omitted. 

In general only 0-^^ in^'3"^ ^2" 
C t ext ai is ^ef fn^nrarproprfate Pxace in the 
buffer! P While ed is accepting text, ^is^^ 

to be in inpu| mode. *" ^^ely collected, 
are recognized; all input is mery^ alone 

input mode is left by typing v 

at the beginning of a line. 

_ ea supports a U, rf fo ff ^ aggggg 

A member of this set ° £ *"lngs r Th e regular 

S^^.'lSlSSS* STare'construc^ as 

follows: 

, . An ordinary character <-t-%°* r ^„ 
discussed below) is a regui 
and matches that character. 

•ri~ v f*M at the beginning of a reg- 
2. A circumflex ( ) at w y character 
ular expression etches the n 
at the beginning of a line. 

n. n (±\ ai- the end of a regii- 
3. A currency ^bol (£) » *»e ^ character 
lar expression maccnes> 
at the end of a line. 
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4 A period (.) etches any character but a 
new-line character. 

5 . x re,ular expression followed hy an^aster- 
^l^Mm"") of the regular 
expression it follows. 

* v, a . a pvprs enclosed in square 

6 . a string of ch «*£«%£ C * ha racter in the 
brackets ([]) watcnes y howe ver, the 

in the string. 

7 . The concatenation of ^^SK'/SS"^- 
, regular <^"" l ™ r ™£ matched by the 
events or the rebuilt expression. 

sion encountered. 
Reg ul»r expressions are useain^aadresse^^to 

?r sP ecify ne a E P o n r a tio„ °o? a line which is to he 
replaced. 

rf it is desired to use one of ^^character, 
pression metacharacters as^nordxnary ^ also 

?hat character ^* EtS^SSSing the regular 

appUe \on !o?ten V" ) and to V itself, 
expression lorten / / 

Xddresses .reconstructed as tMc^ £ ^«" 
stand adaressing in 2§ " ;% urren t line. Gen- 
that at any time ^" " * £ fl„Tl;sThe last 
erally speaking, the curr ent ii» t 

fine Lfectea by » -rjine' b^ach command is 
SU£.S Sdertnrdescriptlon or the command. 

,. The character "." addresses the current 



line. 



•"*" addresses the line im- 
- T m h eaiftriy C heIore thfeurrent line. 

v „tpr "s" addresses the last line 

3. The character s 
of the buffer. 

4. X aecimal numher n aaaresses the nth line 
of the buffer. 
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6. A regular expression enclosed in slashes 
"/" addresses the first line found by 
searching toward the end of the buffer and 
stopping at the first line containing a 
string matching the regular ex P res f io ?' If 
necessary the search wraps around to the 
beginning of the buffer. 

5 a regular expression enclosed in queries 
-■?*• addresses the first line found by 
searching toward the beginning of the 
Sferand stopping at the first line found 
containing a string matching the regular 
expression. If necessary the search wraps 
around to the end of the buffer. 

7 An address followed by a plus sign "+ or a 
7 * m?nus sign "-" followed by a ^imal number 

specifies that address plus (resp. minus; 
the indicated number of lines. The plus 
sign may be omitted. 

8 "V addresses the line associated (marked) 
8 ' with the mar* name character x which must 

be a printable character. Lines may be 
marked with the \" command described 
below. 

Commands may require zero, one, or t* ^ r ^ eBa 

Commands which require no addresses regard tne 
Presence of an address as an error. Commands 
Shlch accent one or two addresses assume default 
Presses when insufficient are given. If more 
Stresses are given than such a command requires, 
?he list one or two (depending on what is accept- 
ed) are used. 

Addresses are separated from each other typically 
byTcomma ( ) . ^- ^i^rcSS'Sn?"!- 
Semi Be ? To ihe'the previous address before the 
nlxradSJess'is^inferpreted. This feature can be 
uled to determine the starting„line for forward 
and backward searches ( / , ? )• *"„_; 
address of any two-address sequence must 
correspond to a line following the line 
corresponding to the first address. 

in the following list of ed commands, the default 

used to show that the given addresses are the 
default. 

As mentioned, it is generally illegal for more 
than one command to appear on a line. However, 
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any command may be suffixed by "p" (for "print"). 
In that case, the current line is printed after 
the command is complete. 

(.)a 
<text> 

The append command reads the given text and 
appends it after the addressed line, 
is left on the last line input, if there 
were any. otherwise at the addressed line. 
Address o" is legal for this command; text 
is placed at the beginning of the buffer. 

(.,.)c 
<text> 

The change command deletes the addressed 
lines, then accepts input text which re- 
places these lines. . is left at the 
last line input; if there were none, it is 
left at the first line not changed. 

''ihe delete command deletes the addressed 
lines from the buffer. The line originally 
after the last line deleted becomes the 
current line; if the lines deleted were 
originally at the end, the new last line 
becomes the current line. 

e filename , 

The edit command causes the entire contents 
of the buffer to be deleted A and then the 
named file to be read in. . is set to 
the last line of the buffer. The number of 
characters read is typed. filename is 
remembered for possible use as a default 
file name in a subsequent r or w command. 

f filename 

The filename command prints the currently 
remembered file name. If filename is 
given, the currently remembered file name 
is changed to "filename . 

( 1 .$)q/regular expression/ command list 

in the 2 lobal command, the first step is to 
mark every line which matches the given 
regular expression. Then for every such 
line, the given command list is executed 
with "." initially set to that line. A 
single command or the first of multiple 
commands appears on the same line with the 
global command. All lines of a multi-line 
list except the last line must be ended 
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with *V. a, i, and c commands and associ- 
ated input ^re-permitted; the terminat- 
ing input mode may be omitted if it wouiq 
be on the last line of the command list. 
The (global) commands, fl and v, are not 
permitted in the command list. 

(.)i 
<text> 

* This command inserts the given text before 
the addressed line. . is left at tne 
i»««- line input: if there were none, at tne 
last line i^put-, i command differs from 
addressed line. Tbis comma f th 

the a command only in the placement 

text. 

(#) The mark command associates or marks the 
fddrLs-ed line with the singl* ^racter 

rames n ar e e remembered!^ current ma* 
names may be printed with the n command. 

( " T he list command prints the addressed lines 
In an unambiguous way. Non-printing char 
Meters are o^er-struck as follows: 

char prints / 

bs \ 

tab > 

ret < » 

SI * 

Mi^aracters preceded by a prefix (ESC) 

with the sequence \newime. 

(•t*) 11 ^ ~~a will reDOsition the ad- 
The Sove command will reposi ed by 

jessed lines after the^lin^^ ^ 

Ane ^ed'becomes'the current line; if «£ 
lines moved were °"9ijally at the J • 
new last line becomes the current 

n The marknames command will print the 
current mark names. 

(•»*'P „„j prints the addressed 

The print command print s^the^ ^ ^.^ 

^^The e command may be placed on the 
same line after any command. 
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NAME 

SYNOPSIS 

DESCRIPTION 



od 



octal dump 



od name [ origin ] 

rf dum ps a file in ^Ve^thtTefC %T« 
^ith the origin of the line on e& to ^ 16 

S^ SStS W sfnaU-en interrupt .„».!. 

4- e o^ic but reads to the desired 
SK& Toint:^ Uathjthan ft, shouia b e 
used to dump special files. 



FILES 




SEE ALSO 


db(l) 


DIAGNOSTICS 


"? M 


BUGS 


— 


OWNER 


ken, dmr 
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3 



The cjuit command causes ed to exit, 
automatic write of a file is done. 



No 



($)r filename 

The read command reads in the given file 
after the addressed line. If no file name 
( is given, the remembered file name, if any, 

is used (see e and f commands). The remem- 
bered file name is not changed unless 
"filename" is the^very first file name men- 
tioned. Address "o" is legal for r and 
causes the file to be read at the beginning 

* of the buffer. If the read is successful, 

the number of characters read is typed. 
"." is left at the last line read in from 

| the file. 

! ( .,. )s/regular expression/replacement/ or, 

( . , . ) s/regular expression/replacement/g 

The substitute command searches each ad- 
! dressed line for an occurrence of the 

♦ specified regular expression. On each line 

in which a match is found, all matched 
strings are replaced by the replacement 
specified, if the global replacement indi- 
cator "g" appears after the command. If 
the global indicator does not appear, only 
the first occurrence of the matched string 
is replaced. It is an error for the sub- 
stitution to fail on all addressed lines. 
Any character other than space or new-line 
may be used instead of "/ to delimit the 
regular expression and the replacement. 

. is left at the last line substituted. 

The ampersand *V appearing in the replace- 
ment is replaced by the regular expression 
that was matched. The special meaning of 
"&" in this context may be suppressed by 
preceding it by \ . 

! 

( 1 ,$)v/regular expression/command list 

This command is the same as the global com- 
mand except that the command list is exe- 
cuted with "." initially set to every line 
except those matching the regular expres- 
sion 

( 1 ,$)w filename 

The write command writes the addressed 
lines onto the given file. If the file 
does not exist, it is created mode 17 
(readable and writeable by everyone). The 
remembered file name is not changed unless 
"filename" is the very first file name 
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mentioned. If no file name is given, the 
remembered file name A if any, is used (see 
e and f commands). . is unchanged. It 
the command is successful, the number of 
characters written is typed. 

($) = 

The line number of the addressed line is 
typed. "." is unchanged by this command. 

IUNIX command .. .. 

The remainder of the line after the ! is 
sent to UNIX to be interpreted as a com- 
mand. "." is unchanged. 

(.+l)<newline> 

An address alone on a line causes that line 
to be printed. A blank line alone is 
equivalent to \ + 1p ; it is useful for 
stepping through text. 

If an interrupt signal (ASCII DEL) is sent, ed 
will print a ?" and return to its command level. 

If invoked with the command name '-', (see init)„ 
ed will sign on with the message Editing system 
"and print *" as the command level prompt charac- 
ter. 

Ed has size limitations on the maximum number of 
Tines that can be edited, and on the maximum 
number of characters in a line, in a global s 
command list, and in a remembered file name. 
These limitations vary with the Physical core 
size of the PDP11 computer on which ed is being 
used. The range of limiting sizes for the above 
mentioned items is; 1300 - 4000 lines per f lie , 
256 - 512 characters per line, 63 - 256 cnarac- 
ters per global command list, and 64 characters 
per file name. 



FILES 



/tmp/etm? 
/etc/msh 



temporary 

to implement the 



l" command. 



SEE ALSO 
DIAGNOSTICS 
BUGS 
OWNER 



? for any error 



ken, dmr, jfo 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



EXIT(I) 



exit terminate command file 

exit 

exit performs a seek to the end of its standard 
THput file. Thus, if it is invoked inside a file 
of commands, upon return from exit the shell will 
discover an end-of-file and terminate. 



if(l), goto(l), sh(l) 



dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



fc . fort ran compiler 

fc [ _c ] sfile 1jt f ... ofile 1 



fc is the UNIX Fortran compiler. It accepts 
three types of arguments: 

Arguments whose names end with \ff" are assumed 
to Z Fortran source programs; they are compx led, 
and the object program is left on the file 
sfile o (i.e. the file whose name is that of 
?he sou?ce with \o" substituted for .f ). 

Other arguments (except for "-c" ) are assumed to 
be either loader flags, or object programs, typi- 
cally produced by an earlier Jc run °r Perhaps 
libraries of Fortran-compatible routines. These 
progfams? together with ?he results of any compx- 
?=4-<™Tq 4necified are loaded (in the order 
g£E3 tl^odict'an executabXe program with nam* 
a. out . 

The H _c" argument suppresses the loading Pj as ®, 
2 does an^syntax error in any of the routines 
being compiled* 

The following is a list of diff fences between ^ 
and ANSI standard Fortran (also see the BUGS 
section): 

1 Arbitrary combination of types is allowed in 
1 * Expressions. Not all combinations are expect- 
ed to be supported at runtime. All or tne 
normal b conve?sions involving i^-JJJj^^ 1 - 
double precision and complex are allowed. 

2. The 'standard' implicit statement is recog- 
nized. 

3 The types doublecomplex, logical*1, integer*2 
and real*8 (doubleprecision) are supported. 

4. & as the first character of a line signals a 
continuation card. 

5. c as the first character of a line signals a 
comment # 

6. All keywords are recognized in lower case. 

7. The notion of 'column 7' is not implemented. 

*. 4~r>,rh -i q free form — leading blanks 
8 - 2^Sr^V.%'i r rS tlank a f er th. start 
of the number terminates the field. 
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9. A comma in any numeric or logical input field 
terminates the field. 

10. There is no carriage control on output. 

In I/O statements, only unit numbers 0-19 are 
supported. Unit number nn corresponds to file 
"fortnn;" (e.g. unit 9 is file fort09 ) For 
input^the file must exist; for output, it will 
be created. 

ftles file.f i n P ut file 

F a out loaded output 

f .'trap [123] temporary (deleted) 

/usr/fort/fc[1234] compilation phases 

/usr/lib/frO.o runtime start off 

/usr/lib/filib.a interpreter library 

/usr/lib/libf.a builtin functions, etc. 

/usr/lib/liba.a system library 

SEE ALSO ANSI standard 

nTAGNOSTICS Compile-time diagnostics are given by number. I 

DIAGNOSTICS ^ he P source cod e is available, it is printed with 

an underline at the current character pointer. 

Errors possible are: 

1 statement too long 

2 syntax error in type statement 

3 redeclaration 

4 missing ( in array declarator 

5 syntax error in dimension statement 

6 inappropriate or gratuitous array de- 
clarator 

7 syntax error in subscript bound 

8 illegal character 

9 common variable is a parameter or already 

in common 

10 common syntax error ,. . 

11 subroutine/blockdata/f unction not first 

statement 

12 subroutine/function syntax error 

13 block data syntax error 

14 redeclaration in external 

15 external syntax error 

16 implicit syntax error 

17 subscript on non-array 

18 incorrect subscript count 

19 subscript out of range 

20 subscript syntax error 

23 equivalence inconsistency 

24 equivalence syntax error 

2 5 separate common blocks equivalenced 

26 common block illegally extended by 
equivalence 

27 common inconsistency created by 
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equivalence 

29 () imbalance in expression 

30 expression syntax error 

31 illegal variable in equivalence 
33 non array/function used with 

subscripts/ arguments 

35 goto syntax error 

37 illegal return 

38 continue, return, stop, call, end, or 
pause syntax errpr 

39 assign syntax error 

40 if syntax error 

41 I/O syntax error 

42 do or I/O iteration error 

43 do end missing 

50 illegal statement in block data 

51 multiply defined labels 

52 undefined label 

53 dimension mismatch 

54 expression syntax error 

55 end of statement in hollerith constant 

56 array too large 
99 p table overflow 

101 unrecognized statement 

Runtime diagnostics: 

1 invalid log argument 

2 bad arg count to amod 

3 bad arg count to atan2 

4 excessive argument to cabs 

5 exp too large in cexp 

6 bad arg count to cmplx 

7 bad arg count to dim 

8 excessive argument to exp 

9 bad arg count to idim 

10 bad arg count to isign 

11 bad arg count to mod 

12 bad arg count to sign 

13 illegal argument to sqrt 

14 assigned/computed goto out of range 

15 subscript out of range 

100 illegal I/O unit number 

101 inconsistent use of I/O unit 

102 cannot create output file 

103 cannot open input file 

104 EOF on input file 

10 5 illegal character in format 

106 format does not begin with ( 

107 no conversion in format but non-empty 

list 

108 excessive parenthesis depth in format 

109 illegal format specification 

110 illegal character in input field 

111 end of format in toller ith specification 
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999 unimplemented input conversion 

BUGS The following is a list of those features not yet 

implemented: 

loading of common (a ELOCK DATA program must be 
written to allocate common). 

arithmetic statement functions 

data statements 

backspace, endfile, rewind runtime 

binary I/O 

no scale factors on input 

OWNER dmr » ken 
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NAME fed — edit associative memory for form letter 

SYNOPSIS fed 

DESCRIPTION fed is used to edit a form letter associative 
DESCRIPTION _ form ^ which ±t of earned 

strings. Commands consist of single letters fol- 
lowed by a list of string names separated by a 
single space and ending with a new line. The 
conventions of the Shell with respect to * and 
*->* hold for all commands but e and m where 
literal string names are expected. The commands 



are: 



. i e name. 






edit writes the string whose name is name 1 
onto a temporary file and executes the sys- 
tem editor ed. On exit from the system edi- 
tor the temporary file is copied back into 
the associative memory. Each argument is 
operated on separately. The sequence^ of 
commands to add the string from file to 
memory with name 'newname is as follows: 

e newname 

(printed by ed) 

r file 

w 

q (get out of ed) 

q (get out of fe) 

To dump a string onto a file: 

e name 

200 (printed by ed) 

w filename 

q (get out of ed) 

q (get out of fe) 

d [ name. ... ] 

deletes a string and its name from the 
memory. When called with no arguments d 
operates in a verbose mode typing each 
string name and deleting only if a y is 
typed. A 'q' response returns to command 
level*. Any other response does nothing. 



m name, namej • • • 

(move) changes the name of name 1 to name 2 
and removes previous string name, i f °» e 
exists. Several pairs cf arguments may t>e 
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given, 



n [ name^ 



lEE^itVim. tho." requested. 



p narne^ 



prints the contents of the strings with 
lames given by the arguments. 

( 3 uit) returns to the system. 



c [ o 1 E * 1 



following: 

p causes any unaccounted for string to be 

printed 

f fixes broken memories by add ing 
unaccounted-for headers to free st 
«nd removing references to releasee 
beaded from associative memory. 



FILES 

SEE ALSO 
DIAGNOSTICS 



/tmo/ftmo? temDorary 
form.m associative memory 

form(l), ed(l), sh(l) 

'?< unknown c °™* nd f ile <__ can not create a tem- 

'Cannot open temo. flie 

porary file for ed command < na me' is not in 

"'name not in memory. if strx g ^ argument 

the associative memory and is usea 

for d or m. 



BUGS 
OWNER 



rhm,Hc 
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NAME 

SYNOPSIS 

DESCRIPTION 

FILES 
SEE ALSO 
D IAGNOST ICS 
BUGS 
OWNER 



FIND (I) 



find 



find file with given name 



find name or. number ... 

^ searc r e ^ h T*: !f u iii y ii?^ith r ?K 

and gives the path names or <"■■«• j--"--^ 
specified names or (decimal) i-numbers. 

L 



dmr 
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form — form letter generator 



NAME 

SVNOPSIS form proto a^ ... 

A >. . f„rni -fetter from a prototype 
DESCRIPTION ff^ e f n r n Tssociative memory, arguments and in a 

special case, the current date. 

If form is invoked with thj ;J rc£ ^^entry 
the-aHociative jemory^- jearchea under that 

with name x and the co """V _ f the sea rch 
name are used as th e ^ototype^J ft ^ ^^ 
fails, the message [x J. is W conS olQ, 
and whatever text iB W^. 111 ^ use d as the pro- 
terminated by two new lines, is us 

totype. 9 

If the prototype ardent i. missing, -tetter}' 

is assumed* 

Basically form is • eaw e™^^? Sf °" 
type to the outout f lie .11 9) ls 

form [n] (where n is a ^ig" f J°™ ls lnS erted in 
encountered the Bth'rg^en^arg^ r# -# , 

^[SPis'enoounterea/the current date is in- 
' sertei If the desired "?™8"* *S» ™^. 

, lv en, a message of th e form W- ^ ^ , rgu . 

The response typed in men 

ment. 

\ If an element of the form [n.£] or J.^^. 

, encountered, ^e name is looKe d p contents f 

ative memory. If ^ e! i J a l° Replaces the original 
the memory under ^^T^^the name is not 
element (again rescanned ).. 1* t jM ±s typed# 

found, a message ° f *** f °™ d £ or that element. 
The response tjf^^Se memory under the 
The response is e " te ^\ nc5ed in n . The response 
name if the name is en closed in U ^ remembered 
is not entered in th e ™ e ™^y *ut the nam e is 
for the duration of the letter 
enclosed in {}. 

„ hoth of the ^ «=«;* i e ZllT,Z iy sr" 

n^lnfst^Snirtnffirsr of the two new lines 
is passed with the text. 

of the special characters [{] }\ i« preced- 
ed ?y e a \, i? KS. it. -ecial character. 

If a f UK named ^-^^ir^^as^the'outPUt 
users directory, for ?* *> 
file and so forth to formz . 
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The file "form.*." is created if none exists. 
Because form.m is operated on by the disc allo- 
cate^ it should only be changed by using fed, 
the form letter editor, or form. 

PTTE e form.m associative memory 

form? outout file (read only) 

SEE ALSO fed(l), tyoe(l), roff(l) 

T.TAPNOC5TICS "cannot open output file" "cannot open memory 
DIAGNOSTICS ^c^ ^^ ^ appropriate files cannot be locat- 

ed or created. 

BUGS An unbalanced ] or } acts as an end of f ile but 

BUGS ma y add a few strange entries to the associative 

memory. 

OWNER rhm.llc 
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NAME 

SYNOPSIS 

DESCRIPTION 



goto 



__ command transfer 



goto label 

4-v,^ <?>iell is taking 
gsto i. only alio.- "hen 'he shell search ed. (fro. 

^FSands f f"\%fr I'line beginning with : M" 
the beginning) for a ""! /| ollowe d by the 
lowed by one or mo « "P« e | *° ^, comm and 

^s/Vinfe the? |d Point e in the co^and 
l^if tVcaSI iheYhelfto transfer to the 
labelled line. 

-,- is a do-nothing command that only serves to 
place a label. 



FILES 

SEE ALSO 

DIAGNOSTICS 



" if the input file is a typewriter, 
goto error , i f „ tne 1UF 
"label not found . 



BUGS 
OWNER 



dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



IF (I) 



if _- conditional command 
if expr command [ arg,| ... J 

the given arguments. 

* ri.* +••««<*<? are used to construct 
The following primitives are u* 

the expr ; 

- f true if the file exists and is readable. 
~ f trSe if the file exists and is writable 

~ f irue if the file either exists arid is 
wri?abLror does not exist and is 
cr eat able. 

81 =«« if the strings si and s2 are equal. 

81 ^frue if the strings si and s2 are not 
equal . 
These primaries *a y he coined with the folic- 

ing operators: 



~ unary negation operator 



-a 



binary and operator 



binary or operator 

1 parentheses for grouping. 

-a has ^i^ er P reC ^r|r a ^ a L?se P a?ate e argu! 
^entftoXaS^enfe musTbe surrounded by 
spaces. 



FILES 

SEE ALSO 

DIAGNOSTICS 



sh(l) 

"if error", if the expression has the wrong 

syntax; "command not found. 



- 1 - 



IF (I) 
3/15/72 

--c- always indicates the file is creatable, even 
BUGS if it isn't. 

OWNER dmr 
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6/12/72 

NAME 
SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 

BUGS 
OWNER 



wt* - »•* inode status 

i2 t 2£ inumber, ... ..nodes 

^TT oives information about one or more 



— same for as 

following: 

« -. i-node is allocated 

1: file is large 

3 d: file is a Rectory 

u: set u above 

-: none or tne ~^ 

4 r: owner can reac * , 
Is owner cannot read 

5 - oXner canncTwrite 

6 I! -n^ner SoSl- 

7 I! r^er c^nofwrite 

, «* always given in symbolic 
Th e owner *%f ^/clnnotbe found in 

t&JSr?^ - *'~ „, is not e X aot ly 
f .«?5 ^priien?ifcTn g «- — - 
the status information. 

/etc/uids, /dev/rkO 

stat(l) lsd) (-1 option) 

-name?" for any error. 

^i alternate tli eb i^ 
is tat should taKe an opt.onal altern 

tern argument . 
dmr 
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LD (I) 



NAME 

SYNOPSIS 

DESCRIPTION 



ld link editor 

Id [ r usaol ] name 1 ... 

„., r>v.<ect programs into one; 
Id combines sever ^f^f ^ searches li- 
Tesolves external 5 e ^ren ces» of 

braries. In the s^f ^ase tn and Id corn- 
several object P ro ? ram ! "J^ module which can 
bines them, producing a * ^^^put for a„ 
be either executed or become Jh -^ 

-firm^be-given^to P^erve the relocation 

bits. 

»• ««««* routines ~ ^"^oSj* 

STS/SS^ of ^"f irs? routine. 

,.. rarv it is searched 
If any argument is a i^ a ^ utine s defining an 
exactly once. Only those rout in ^ Jf a 

unresolved externa ef ^ ^^ ine 

routine from a ^rary re routine must ap- 

i„ the li bra ^» r S^ renc I n g routine in the li- 
brTry! ft T e huf the e o?re? C or g iibraries is important. 

ld understands several.,^ arguments which are 
Mitten preceded by a - : 

_ "squash" the output ^* "^ftoVave 
sy^oltatle and relocation bits to ^ 

S^ Thf/iSor.ation can aiso be 
removed by strip,. 

_u take the following [^Tn^l^Tllll^ 
enter it as ™ d fi n **J£ n Zu to iiy from a 
This is useful f^ t ^iw?b e symbol table 
library, since i^^J^reference is 
iUSTKo'SrS XeToadLg of the first 
routine. 

.1 This option is an gj^ f° r & ^ 

^/?~ii-^ --mbiy fangfageTro^ 
system library for assembly ugr/ g ib/1 

grams. -lx s t"" a ^ pr There are li- 
where x is any character. Tb (x="c"), 
braries for Fortran (x-Ji 
Explor (x= e ) and B (x t> ;. 

_ x Bo not preserve ^"Z'&fl^* 
in the output «****£* l*£l Javes some 
external symbols. This opx: 
space in the output file. 



- 1 
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FILES 

SEE ALSO 
DIAGNOSTICS 



BUGS 
OWNER 



LD (I) 

run. 

The output of Id i^ii^s^^rr^durin^the 
executable only if no errors occ 

load. 

/usr /lib/lib?. a libraries 
a.out output file 

as(l), ar(l) 

"file not found"- bad argument 

"bad format"— bad argument 

"relocation error"- bad argument (relocation 

bits corrupted) 

same load 

■W- stands for "undefined symbol" 

"symbol not found"- loader bug 

fc „«. fi1P " can't move temporary 

"can't move output file - can 

to a.out file 

w<«- e " and input file lacks relo- 
"no relocation bits — ana mp 
cation information 

, *• 4-^rt manv references to 
"too many symbols - too many r^ 
external symbols in a given 

"premature EOF" 

"can't create l.out"- cannot m a*e temporary file 

4^4-- more than one entry 

"X^-" 3 ^"^.ts. Vet,. 

instructions in the data sec.ent are net relccat- 

ed properly. 

dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



LN (I) 



In 



make a link 



In name 1 [ name 2 1 



JB creates . • "*,« ".^ SSt' ^""1^S« 
SfS PlaceHA tne current directory ana it, 
nine is the last component of name, . 
It is forbidden to 11* to a directory or to linK 
across file systems. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



rm(l) 



- 9 - 



Th ere is nothing Pf*^*" 1 ?^ to'th^backup 

&-cS5.^. --4 ■? s - information that 

a link was involved is lost. 



OWNER 



ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 
DIAGNOSTICS 



LOGIN (I) 



login — sign onto UNIX 

l OCT in [ username [ password ] ] 

* ** „ e pfl when a user initially 
The login command is used «£" at any time to 

See t ^^vS a |orho W ab °to e dial up initially. 

If login is invoiced without -ardent it will_ 
ask-fSra user name and if ^P r ^ ssibl ^) dU ring 
word, echoing is turn-off W* ±ll not appe ar 

f n e t h^rItfen th r e eiS S of the session. 

**« 5 ^r^user^inlormef K'exisTence 
^fa^o^anrmesfagUf-the-day files. 

L ogin is recognized by the Shell and executed 
directly (without forking). 



account ing 

account ing 

mail 
message-of-the-day 



/tmp/utrap 
/tmp/wtmp 
mailbox 
/etc/motd 

login(VIl). init(VIl), getty(VIl) , mail(l) 

~«-" if the name or the password's 
login incorrect,,, if the n word file, 

ad . No Shell, ,canno y 'ramming coun- 



bad 

"no directory: 

cilor. 



consult a UNIX prog] 



BUGS 
OWNER 



dmr, ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



LS (I) 



ls __ list contents of directory 

Is [ -ltasd ] name., ... 

is lists the contents of one or more directories 

Tinder control of several options: 

1 list in long format, giving 1-"™*?%™°**' 
owner, size in bytes ** ta»e of last 

modification for each file. ^ see 

format of the mode) 
t sort by time modifies (latest first) instead 

of by name, as is normal 
a list all entries; usually those, beginning 

with "." are suppressed 
s give size in blocks for each er*ry 
a if araument is a directory, list only its 

vf^UK^^'^^r with 

If^eSTsTot 1 * SSSo^ ^™is fivln. 
/eto/uids to get user ID's for Is -*' 

"name nonexistent"; "name unreadable"; "name 
unstatable. 



BUGS 
OWNER 



dmr, ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 
DIAGNOSTICS 



MAIL (I) 



mail __ send mail to another user 
mail [ letter person ... 1 

ESii „ithout an "S-TVIFpU.Sn and"** if 
Hiled mailbox, print s it if pr ^ - - the 

it shouW be saved. If tne an dieted. 

„il 1. "^thfifeve question may be supplied 

The answer to tne aoove h 
in the letter argument . 

** ^ i ^tter and one or 
When followed by £j £»£ fppLde^o each 
SSiS~ P ifil£S- ^J lette? is preceded by the 
?enSe?'s ^ETSiSd * postmark. 

• a< f>,pr the name of an entry in the 
A person is either tne n«u sent to 

difetoly /usr, in wh ^ h t °* S ! a tS n^me of a direc- 

imi^*^'^^ ±n that directory is 

used. 

«,„ a user lo 9 s in be is informed of th. pres- 

ence of mail . 



to map uids 
input mail 
saved mail 



/etc /uids 

mailbox 

mbox 

login (I) 

,,- if the user cannot be identifed. 
"Who are Y° u ' l f *£" Y" "cannot send to user 
for some reason (a t>ugj. v. 
if mailbox cannot be opened. 



BUGS 
OWNER 



Ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



MAN (I) 

raan _ run off section 'off UNIX manual 
man title [ section ] 

section is the section n«i section is miss- 

Arabic, not Roman numerals.) If section x 
ing, I is assumed. For example, 

man man 
would reproduce this page. 
/ sy s /man/man? /* 
sh(l), roff(l) 
"File not found", Usage .. 



ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



MESG (I) 



mesg — permit or deny messages 
mesq [ n ] [ £ 3 

^ n forbids ■«•*" » l » ^ u ^rt£2rit- 

' ^ ^er write permission on tne user *> UJ *\, wrk 
2? melq V reinstates permission, mjjH with no 
araumln^riverses the current permission. In all 
S2S?he previous state is reported. 

/dev/tty? 

write(l) 

- ? - if the standard input file is not a typewrit- 

er 



dmr, ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



MKDIR (I) 

^dir _- make a directory 

mkdir dirname . .. 

rcxair creates specified directories in mode 17. 

Th e standard entries "." and ".." «• * ade aU " 
toraatically. 



rrodir(l) 
"dirname ?' 

ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



mount — mount file system 



/etc /mount special dir 

nount announces to the system *at a removable 
^ SyS Ti n r:o b s P e=ra? "fUelS Director 
If the root of the newly mounted file system. 



OWNER 



umount(l) 

"9" if the special file is already in use, can- 
not' be read, or if dir does not exist. 

Should be usable only by the super-user. 

pack, 
ken f dmr 
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MT (I) 
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NAME mt - manipulate magtape 

SYNOPSIS «& [key ] [ name ... ] 

«- » ftrsyMss £&£*&£. . 

are controlled by tne ££* ;{ t ^gt one func- 

string of characters coa tain ing £ fj^^ 
tion letter and possibly one o r mo are 

modifiers. Other ax foments to the co ^^ 

-File or directory names specnyiny 
are to be dumped, restored, or tabled. 

. . nf 4.-HP vev is specified by 

The function portion of the key P 

one of the following letters. 

onto the tape. The old contents of the 
tape are lost. 
x extracts the named files from the tape to 
Stei^lffeTare re^efto^ t S!^ 

the tape are extracted. 

t list, the names of '" f ^rT/etierarcn- 
tape which are the same as or are 

icSlly below the "^ n -?- fnlire'lontents 
file argisnent is given, trie 
of the tape are tabled. 

1 is the same as t except that an expanded 

7 This modifier selects the drive on 

* which the tape Is mounted. is the 
default. 

v Normally mt does its "f^^o^e'thfnie 

to indicate what is happening. 

a file is being added 

x file is being extracted 

The v option can be used with r and x only, 
f causes new entries copied on tape to be 
- 1 - 
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FILES 

SEE ALSO 

DIAGNOSTICS 



BUGS 
OWNER 



MT (I) 



'fake' in that only the entries, not the 
data associated with the entries are updat- 
ed. Such fake entries cannot be extracted. 
Usable only with r. 

w causes mt to pause before treating each 
file, type the indicative letter and the^ 
fileni (as with yj and await the users 
response. Response y means yes , so the 
file is treated. Null response means no , 
and the file does not take part in whatever 
is being done. Response x means exit, 
the mt command terminates immediately, in 
the ^"function, files previously asked 
about have been extracted already. With r, 
no change has been made to the tape. 

m make (create) directories during an x if 
necessary. 

i ignore tape errors. It is suggested that 
this option be used with caution to read 
damaged tapes. 

/dev/mt? 

tap(l), tap(V) 

Tape open error 
Tape read error 
Tape write error 
Directory checksum 
Directory overflow 

SK.°^S°(a file has changed after it was 
select!! for dumping but before it was dumped) 



The m option does not work correctly, 
option is not yet implemented. 



The i 



ken 
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NA ME - - move or rename a file 

SYNOPSIS BL name, name 2 llnKing to it 

DESCRIPTION mv changes the name of ^l^^inking nam ei . 

directory (just renamed). 

FILES 
SEE ALSO 

AGNOSTICS - imDleroente a b y cognations of linjc 

SJStfU: it P Ste Lea to »e between 



OWNER 



file systems 
ken, dnir 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 



*6 (I) 



m6 _ general purpose macro processor 

26 [ ^ argl 3 t «rg2 [ arg3 ] 1 

,,,. -y-a-y (or standard input 
m6 takes input from f ^ e ^^ K ° utDUt on file 
if arg2 is missing) and pi * ces ° ± file of 
arg3 (or -tandard output). J worg fron 

d afai ni if that implied. M6 differs from the 

standard [1] in these respects: 

# trace:, #source: and #end: are not defined. 

«p^« ^v*^ role of metachar- 
#meta,arg1,arg2: transfers t he r ol ^ metacharac _ 

acter argl to chara cter arg2. I ome of 

ters become identical thereby^ t* ^ exam _ 

XTtl mare e n1} g play n °t- 9 -le S of *:<> type 

\#meta,<\#>,C: 
[meta,<:>,l : # n 

[meta,[substr,U»,2,1,,)J 

file m. def . 

wlth tne e *" n i:^ 8 use tne n^-ero to perfori. 
plied to arg3 to cause tn before its 
th e action of . spec "J*,^ Thus =11 *»!««>• 
SSi^^. SS "e fetrieveo even after 6ele- 
tion. Codes for arg3 are: 

l'X,VX™ - eaa,euo. n oy,aiv,exp 

20 - if . . 

21,22 - def,copy 

23 - meta 

24 - size 

25 - substr 
26,27 - go,gobk 

28 - del 

29 - dnl 

30,31 - save, rest 

%-^f^/^!-fe ProcS^prooer (/.in/- 
^r/iL^r^faekuit initialisation for 

- 1 - 
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m.def 

SEE ALSO [1] *6 reference 

~ err " __ a bug, an unknown builtln or a bad de- 
DIAGNOSTICS finition table initial definitions 

"oord;~can;t ooen J-^^S^ - overflow of 

"opwr — can't open output ovc 

S "-I S SS.-SKS.^.. -«« on 
^vefo "n ,«*»». coUection 

-i ♦-aWl^s are stored one per 

capacity. For / nt nofi e arguments have been 
unpacked formats) ™ f *,l%£.Aq*i.n to save space, 
SSSSf cSlSSi ro akes e cails g on # save: and 
Srest! and so overwrites m.def. 

OWNER doUg 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



nm 



nm 



print name list 

[ name ] 



Hill L * " 

wo ¥*x\ e from the output file 
nm prints the symbol table fror» ^ 

3f an assembler or lo ^J r f ^nks if undefined) 
° is preceded by ^^^u^^^ef ined) "a" (abso- 
and one of the letters u £™ - D » (data seg _ 
i 4.^^ "t (text segment symbol ; , » \ ri q _ 

lute) T J ^exc «y„ segment symbol). Glo 

ment symbol), or © \ . character under- 

Sfnert e 5S* f/sfr^ a lp ha b eti=ally. 

If no file is given, th. «»*»1» *» JU°i* «• 
listed. 

a. out 

as(l),.W(l) 
"9" 



dmr, ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



od 



octal dump 



od name [ origin 3 



oa neu» c L w- -3- 

* dumps a .11. in l^l^lfZ 1 ^}?}'^ 

°aS dumping starts ft-^S^oMil. condition 

-v hut reads to the desired 
Since od townotBe*^ s ^ uld be 

starting point, og_ r |£?~ — 

used to dump special files. 



FILES 




SEE ALSO 


db(l) 


DIAGNOSTICS 


"?" 


BUGS 





OWNER 


ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 
DIAGNOSTICS 

BUGS 



opr 



off line print 



opr f ile 1 • . • 

..-n arra nae to have the 201 data phone dae- 
g£ s^imoh £ the Honeywell 6070 to print 

the filearg r ents f-ffo^^hen'the'lata 

printed in the state it is xo 

phon e daemon reads it f ^^\ ±11 make a 

S^for the P dfe^n t/prH*. If the file argu- 
ment is preceded by - then opr will unlink the 
file. 



/usr/dpd/» 
/etc/ident 
/etc/dpd 



spool area 

personal ident cards 

daemon 



OWNS* 



dpd(l), ident (V) 



e> ,. «n but the + option in opr is implemented 
witSll^sronfcanno? use these options for 
files not in /usr. 

oet should recognize ± and = alone and apply them 
to all subsequent arguments. 

ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



OV(I) 



ov overlay pages 

ov filename 

ov ls a postprocessor for proving *%>%££" 
battel t«t when -i"^™"'^ *&,„ of 66 
fine P^ana tl^rfuy over! ays successive 
pairs of pages. 

none 

nroff(l) 

none 

Other page lengths should be permitted. 

jfo 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



PR (I) 



pr __ print file 

pr [ -1cm ] name 1 ... 

a proves .print- ^4' iS£ ^S'Ul- 

number. 

fc 4 »i naa -1 causes each page to contain 
^'linefinsteaa^orthe standard 66 to accommo- 
date legal size paper. 

subsequent files. _js 

Xnterconsole ....... via writed) «. ««*«-« 

during a £r. 

/dev/tty? to suspend messages. 

cat(l), cp(l), mesg(l) 

__ (files not found are ignored) 

none 
ken f <imr 
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NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



REW (I) 



rew rewind tape 

rew [ digit ] 

rew rewinds DECtape dri Y e *' J^^ff romTto 
T^ical tape number, and should range 
7. a missing digit indicates drxve 0. 

/dev/tap? 



"*- if there is no tape mounted on the indicated 
drive or if the file cannot be opened. 



ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



rm 



— remove (unlink) files 



rm name^ . • • 

^•u« orvi-r-iPs for one or more files from 
rm removes the _? n ^ i ^ tr ° r w ts the last link to 
a ^rectory If an en %*£ Removal of a 

the file, the f lie is °«?".J ± its directory, 
^•nSS^"^^^"^..^ on «,. file 
itself. 
Directories cannot be removed by rm; cf . rndir. 

none 
rmdir(l) 

is typed. 

•u^„i^ ack whether a read-only file 
rm probably should asK wnetnw 

IS really to be removed, 
ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



RMDIR (I) 



rmdir 



remove directory 



The direc- 



rrodir dir,j . . . 

rmdir removes (deletes) directories, 
fofv^muJTbe empty (except for the standard en- 
tory must » -* * l whlch ^^ir itself removes), 
wr^e permXsion is requlredlS the directory in 
which the directory appears. 



FILES 

SEE ALSO 

DIAGNOSTICS 



none 



"dir?" is printed if directory dir cannot be 
fouS, is not a directory, or is not removable, 

"dir — directory not empty" is printed if dir 
has entries other than . or ... 



BUGS 
OWNER 



ken, dmr 
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NAME 
SYNOPS IS 
DESCRIPTION 



FILES 

SEE ALSO 
DIAGNOSTICS 

BUGS 
OWNER 



ROFF (I) 



ro ff format text 

roff [ ± number1 ] [ ^number2 3 [ ri^ 1 nari^ . . . 

roff formats text according to control lines 
f^ed in the text in files n-e-' 
Encountering a nonexxstent file terrain * 

Sg. The optional argument +number^c e u ed 
printing to begin at the first p_g - s 

number 1; the optional ar J^^-J^^ . The 
printing after the^page numb ere printing 

^^JofbSo^eachi^e including the first to 
to stop before eacn y y nrintina is resumed 
allow PaPIVS'In 1 irrupt Signal. An inter- 
upon receipt of an ^«""P nri nting terminates 
rupt signal ^ece^ during P rinting a are 

all printing. InComin * ^ a S the original mes- 
turn^d off during pri ntx *?'£££ h ? e rmina- 

sage acceptance state is restore v 

tion. 

••u—i in a seoarate publication [1]. 
roff is described in a sepaiat *> 

/etc/suftab 
/tmp/rtm? 

[1] (See J. F. ossanna) 



suffix hyphenation tables 
temporary 



none 



jfo 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 



;alv _ file system salvage 



, „m reconstruct the file system A>f/ r K° to 
l^nlistenrs^te This is t,e first step in^ 

A valid free list is constructed. 

All bad pointers in the file system are 

z ero ed . 

• «4-^Y-c +-n the same block are 
All duplicate pointers to trie s 

^TntTt eVe^c? conttinSg fcopy of the 

data. 

^-^r^fecrt-e^enre'aSe.^fB^use^e 
stantly to effect the en ng f ue 

S s S p V er".° b foc>craS e the S core P copy is unaffected.) 

Mter a salv. files may be sa fely create^ana 
removed without causing more "oubl ^ are 

corrupfi^s^eir.^a-li s^uid he performed 

/dev/rkO 
check(l), ds(l) 



<--„, ♦-« be salvaged should be an argu- 
The file system to be saivay=u 

ment . 
ken 
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SYNOPSIS 

DESCRIPTION 



SH (I) 



sh __ shell (command interpreter) 

sh [ name [ arg 1 ... C ^9 ^ ] ^ 

ch is the standard command interpreter. It is 
sh is tne su 1 __ afls an a arranges the execu- 

te program "* ic * J 6 ??! J n typed by most users. 
tion of the command 1 in es W Y^ ^ interpret 

It may itself be "lljjo" J the argu _ 

files of commands Before « the truc „ 

;^.%?eS^S e iin« th«^v.. will ** given. 

Command lines 

* nnp s are sequences of commands separated 
Command 1«« "J "J* Eac h command is a se- 
by command delimiters. ^ araU ments separated 
q Jence of ^on-blank command argum en ^^^P^^^ ^ 

by blanks. The first ar f™ en *—+ for certain 
of a command f *• •^fi lB £.SS below, the 
types of ^^f^^e command name are simply 
arauments other tnan tnc „ , 
JSSed to the invoked command. 

If the first argument is the narne of an execut- 
able file, it is invoked £ others ^ 
"/bin/ is prepended to tW arg d in 
way the standard commands S^res^ exist s, 
Vbin", are found.) If the /bin^ sheU as 
but is not executable it is usee y executed as 

a command file. ^^^ef^cm the console, 
input as though it were typea ^ pr±nted# 

If all attempts fail, a uxayi 

T be r gaining ^^^ShSSff^afln^^ 
passed to the command without rux 

tion by the shell. 
Command ^n miters 

^u4ntLi Sfeoution of the coMnands so 
separated; that is, 

coma; comb 

4-.i«r, first of command coma , then 
causes the execution first °£ simultaneous 

of comb. The ampersand & caus 
execution: 

coma & comb 

causes =0^ - ^v- i-'i^liSS 1 ^" bY 

cial case, 

_ 1 - 
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coma & 

, «.- v. pvecuted and the shell immedi- 
ISly'tf?^^ «SSS*co-»4 without waiting 

for coma. 

Termination Reporting 

jt a contend (not follo,adbyV) terminates 

abnormally, a message '■ PJ 1 ** >"', con _ 

abnormal termination messages: 

Bus error 

Trace trap 

Illegal instruction 

IOT trap 

Power fail trap 

EMT trap 

Bad system call 

Quit 

Error 

If a core image is produced, " - Core dumped" is 
append^ to the appropriate message. 

p ^direct ion of I/O 

Thr ee character -quences cause the immediately 

following string to be xntep rete d as P q ^ 

argument to the shell itsexr, nut F 

command . . 

— t nr u s°e! artn^tanoarl £SViX ofthe 

given command • 

An argument of the form "> a ^" ""Ule'fol "*£?" 
to be used as the^tandard ofPUtJ ^ | ia not 

SIS "JT^-ny =«• » «- cated at the 

outset. 

An argument of the form ">>arg" "^f^ 1 *^ 9 
S ^^ed as.the.standard output for*^ , 

STdld ^istTthe ™d output is appended 

to the file. 

feneration of argument l ists 

If ..-^argument contains ^^Ya^f^- 

,Li The current directory is searched for 

mis wMch SLh the given argument. 
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„♦.«,- "»" in an argument matches any 
The character * in an y (including 

string of characters in a tiie n«u« \ 

the null string). 

The character "?" matches any singie character in 

a file name. 

« r" „♦. i, 6 naired with a matching ] . The 
Each [ must be pairea wx pecif y a class of 

characters between [ and j ^ character in a 
characters. It *a tc * e s J lass . An ordinary 

file name ^** ^ScSS specifies that charac- 
character in the brac^t * characters 

ter to be in the claw .A pair ot lexi _ 

separated by - speClf a i! a1 fn the first and less 
ca?ly greater than or equal to the f f ^ 

to^eVc?^ 

fecfnl S^T.^? ~."Saract« specif^. 
Other characters match only the same character m 
the file name. ^ ^ 

"^" .(..koe =11 file names; ? „ 
For example, * "J^ ^ names; ^ab]*.* 
matches all ° n f- cha £ a , Winning with "a or b 
matches all Jii e - n y? 8 «$H££] ^matches all two- 

and ending with .s . • L" * J h « z " or the 

character file names,, ending witn 

letters "i" through m . 

j. <+ .-u "*" or "?" also contains a 
If the argument "it* ° fl is used: 

V\ a slightly different procea directory 

instead of the current directory, ^^t 

used is the one, obtained by taxing „ ?f ^ ^ 

up to the last / £«£J \ he remainder of the 
matching process matches « files in the 

argument after this / *9*"J "/usr/dmr/a*- 8 
SSived directory. For example, / /^ which 
m - r v es all files in direcwry w / 
begin wi?n "a" and end with .. . 

«. * list of names is obtained which 
in any event, a list ot n sorted into 

match the argument, J™ 1 *^ resulting sequence of 
alphabetical order and tn t con taining 

arguments replays the "ngl^ * ss 

the * . L » or ? * Z (*-■*<* resulting lists 

^h^TelSt inf Us? o/ar^ents. 

F or example, directory /^/^"an^ifectcry, 
files al.s, a2.s, .... ay - s - 
the command 



as /usr/dmr/a?.s 
_ 3 - 
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., 11( . as with arguments /usr/dmr/a1 .s, 
%sr/olf/a"s, .!. /usr/dmr/a9.s in that order. 

Quoting 

The character "\" causes the immediately follow- 
ing character to lose any special meaning It may 
£ave to the shell; in this way < , > t & ™ 
o?her ch^Lters meaningful to the shell may be 
passed as part of arguments. A special case of 
thli feature allows the continuation of commands 
onto mire than one line: a new-line preceded by 
"\" is translated into a blank. 

Sequences of characters enclosed in double <") or 
single (') quotes are also taken literally. 

Argument passing 

When the shell is invoked as a command it has 
additional string processing capabilities • ^ 
call that the form in which the shell is invoked 
is 

sh [ name [ arg 1 ... C arg g ] ] J 
Th e none is th. n»e of a file which «£££»? 
.ftnfsne^il oonrinu^rrea^tho standard 
input file. 

m the file, character sequences of the f°™ 
%rT. where n is a digit 0, ..., 9, are repiacea 
bv the nth argument to the invocation of the 
shell (trg n ). "sO** is replaced by name. 

End of file 

An end-of-file in the shell's input causes it to 
S£i? A side effect of this fact * eanS e ^* f the 
way to log out from UNIX is to type an end of 

file. 

Special command s 

Two commands are treated specially by the shell. 

"Chdir" is done without spawning a new process by 
executing the sys cWlr primitive. 
"Login" is done by executing /bin/login without 
creating a new process. 

These peculiarities are inexorably imposed upon 
SeVell by tbe basic structur L of the UKIX^- 
cess control system. It is a r«"a:ui iy 
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FILES 
SEE ALSO 

DIAGNOSTICS 



BUGS 



to work out why. 

Command file errors 

Any shell-detected error in a file of commands 
causes that shell to cease executing that file. 

/etc/glob, which interprets "*", "?", and [ . 

"The UNIX Time-sharing System", which gives the 
theory of operation of the shell. 

"input not found", when a command file is speci- 
fied which cannot be read; 

"Arg count", if the number of arguments to the 
chdir pseudo-command is not exactly 1, or if , 

"9" or "[" is used inappropriately; 
"Bad directory", if the directory given in 
"chdir" cannot be switched to; 

"Try again", if no new process can be created to 
pyecute the specified command; 
^imbalance 6 , if single or double quotes are 

^InpSfineN If an argument after "<" cannot be 

"output file", if an argument aft er > or » 

cannot be written (or created); 

S N S command", if the specified command cannot be 

Wch", if no arguments are generated for a 



j.,^— ... w 

command which contains 



CUUUUCU1U. wux'-ii ww. w 'n_„,^ 

Termination messages described above. 

tff *« •* ** 

if anv argument contains a quoted * , . . or 
" r" then all instances of these characters must 
be quoted. This is because sh calls the Hlob 
routine whenever an unquoted * . ? , or l 1 
noticed; the fact that otber in stances of these 
characters occurred quoted is not noticed by 



OWNER 



dmr, ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BOGS 



OWNER 



SORT (I) 

sort — sort a file 
sort input output 

^ uill sort *:**&*,"•£? ZZl.T*"'*' 

£-! & In fnc^X '£& collate seance. 
Space required is e.nurcber-of -lines in bytes, 
/trap/stm? 



— aces not P^rr^ror^"" °^ £ le 
So^X^rS" InplTfll. is supplied 

^ i"Pf ^^fbatVanTe^edTs^a*- 
Si-SSSiiiJ 5^ Wr«tlY "K bytes.) 

dmr, Ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

OWNER 



stat 



get file status 



stat name. ... 

stat gives sever 
or more files: 



al kinds of information about on< 



i-number 
access mode 
number of links 
owner 

Vklt a^timl of last modification 

£« fusefS when several files are. named) 

A1 information is ^J^^.SS^SSSf.S:. 

mode. The mode is a six-^n~. 
characters mean the following: 

1 s: file is small (smaller than 4096 bytes) 
1: file is large 

2 d: file is a directory 
x*« file is executable 

u . set user ID on execution 
-: none of the above 

3 r: owner can read 

_: owner cannot read 

4 w: owner can write 

_: owner cannot write 

5 r: non-owner can read 

-: non-owner cannot react 

6 w: non-owner can write 

-: non-owner cannot write 

"/etc/uids" a number is given. 

If the number of ."^"^J^h? f iSSfS 
1 a header is generated identxtymg 

the status information. 

/etc/uids 

istat(l), ls(l) (-1 option) 

"name?" for any error. 

dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



strip __ remove symbols and relocation bits 
strip name^j • . • 

assembler and loader. This is u 

space after a program has been aebuggea. 

The effect of strii 
option of Id. 



is 'the same as use of the ^s 



/tmp/stm? temporary file 

ld(l), as(l) 

Diagnostics are given for: »■£«««* ^'^ 
inability to create t^pcraryfrle, 

Sirft/trfe-reao tlporary file. 



BUGS 
OWNER 



dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BU3S 
OWNER 



STTY (I) 

stty — set teletype options 
stty option^ ••• 

from the following set: 

allow even parity, 
disallow even parity, 
allow odd parity 
disallow odd parity 
raw input (no erase/kill) 

negate raw mode (erase/kill) 
allow (and echo) cr for If. 
negate cr mode, 
echo back every character typed. 

do not echo characters as typed. 

ft 

map upper case to lower case 

do not map case 

map tabs M into spaces 

do not map tabs 

ft 



a exaY calculate cr and tab delays. 
f§gi ScS^rSS.r.*- (2741 only) 
fgif correspondence ball conversion (2741 only) 
-ebcdic 
standard output. 

stty( II) 
"Bad options" 



jfo 
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NAME 

SYNOPSIS 

DESCRIPTION 



SU (I) 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



SU 



__ become privileged user 



su password 

su allows one to become the -P--^ W £ *- 
all sorts of marvelous powers. In order tor su 

£ do Its magic, the user must P«J " ^eSf^u 

^ a nAccunrd If the password is correct, su 
Sfl exeSuirthe shell wi?h the DID set to that 

S the super-user. To -f fj/^ e *uper-user 
privileges, type an end-of-file to tne *u P 

shell . 



sh(l) 

"sorry" if password is wrong 

dmr, ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



SUM (I) 



sum 



< — sum file 



sum name . « • • 

along with the number of whole or partial 

word blocks read. 

T ^vtice sum is often used to verify that all 

3 f special fH. can be read without error. 

none 



- ODrd " if the file cannot opened; "? if if 
er?or is discovered during the read. 



an 



BUGS 
0WN5R 



none 
ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



TACCT (I) 

tacc t login accounting by date 

tacct [ wtmp ] 

tacct will produce a printout giving daily con- 
■^.- Hme and total number of connects for all 
^sacTions found in the ^ file. If no «t-p 
file is given, /tmp/wtm pis used. 

/tmp/wtrap 

init(VII), acct(l), login(l), wtmp(V) 

"cannot open 'wtmp' 

acct(l) and tacct(l) should be compined 

dmr, ken 
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NAME tap - manipulate DECtape 

SYNOPSIS tap [ key ] [name ... ] 

J ton letter and possibly one or more function 
*• ^tfiers other^ arguments to the command are 

ffle or directory names specifying which files 
aJe to be dumped, restored, or tabled. 

The function portion of the key is specified by 
one of the following letters: 

r The indicated files and directories, to- 

Srthffape 11 r/iirs^^thf^r" 

King companion, sT/./abc" can never be 
the same as "/usr/dmr/abc even if 
"/usr"mr" is' the current Rectory If no 
file argument is given, . is the default. 

j ,*.««, +.>,« fane u is the same as r, but 
u updates th e tapj.^ u ±f ^ . 

Sate is later than the date stored on the 

is xau changed 

tape; that is to say, ir ^ de fault com- 

since it was dumped, u is tne aaaui 
mand if none is given. 

„ deletes the "-*«* leSt^e"^"^^ 
from the tape. At least one rue iy 

must be given. 

x extracts the named files from the tape to 
tfefile system. The owner, mode and 
da?e-modif ied are restored to what they 
upre when the file was dumped. It no nxe 
^lentis given, the entire contents of 
the tape are extracted. 

' t^SeV-thl ^ e^/Jelie^ch- 

of the tape are tabled. 
1 is the same as t except that an expanded 
li^tina is produced giving all the avail- 
able ^formation about the listed files. 

^ , , .i«~ ^srari-ers mav be used in addition 
S'tS'SSE Shich C sriects Y the function desire*. 
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r 
a 
x 



7 This modifier elects the drive on 
°' ihich the tape is mounted. i. the 

default • 
v Normally tap. does its work silently Thej 

to indicate what is happening. 

'/if. Is SSS| ad e d P ed aC (not there before, 
x file is being extracted 
d file is being deleted 

The v option can be used with r, u, d, and 
x only. 

ning. Usable only with r and u. 

causes new entries copied on tape to be^ 
•f aKe' in that °nly the entries ^ _ 

£" SSTiSf .** ^S^ot be extracted. 
Usable only with r and u. 

causes tap to P»«« ^jV^^'Se 
file, type the indicative let* 8 

file name (as with y] and awa *S * .. the 

«« pennonse y means yes= , "^ 
response. R f*P onB ® ,? response means no , 
file is treated, ^.^p^rt in whatever 
and the "le doee not t^S 8 art - exit « . 

is being done. *^^f es x ^mediately. In 
the tap command terminates imm 

the x function, files P^"^* with r , 

about have been extracted alr ^ y ; the ~* 
S and d no change has been made to the 

tape. 

s maxe (create) directories during an x if 

necessary. 

^vv^-rc It is suggested that 
L ignore tape errors £ x caut ^n to read 
this option be used witn 
damaged tapes. 



FILES /dev/tap? 

SEE ALSO mt^ 1 ^ 

DWWOS.ICS Tape opjn error 

Tape write error 
Directory checksum 
Directory overflow 
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?KJe I?ror°Ta file has changed after it was 
selectel ?or dumping but before it was dumped) 

RUGS The m option does not work correctly. The i 

BUGS option is not yet implemented. 

OWNER ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



TM (I) 



FILES 

SEE ALSO 

D IAGNOST ICS 

BUGS 



tm 



provide time information 



tm [ command arg 1 



3 



Mn -is used to provide timing information. When 
Sed without an argument, output like the follow- 
ing is given: . 



tim 371:51 :09 

ovh 20:00:33 

swp 13:43:20 

dsk 27:14:35 

idl 533:08:03 

usr 24:53:50 

der , 54 



2:00.8 

17.0 

4.6 

4.5 

33.3 

1.2 





1 



The first column of numbers gives totals in the 
named categories since the last time the system 
was cold-Soted; the second column gives the 
changes since the last time tm was invoked. The 
tiTrow is total real time ( hours:minutes: 
liconds); unlike the other times, its origin is 
?ne creation date of tm' s temporary file, o^ is 
time spent executing in the system; swp is time 
waging for swap I/O; dsk is time »P«* waiting 
for file system disk l7o; jM ^ s idle time, usr 
is user execution time; der is RF disk error 
count (left number) and RK disk error count 
(right number). 

tm can be invoked with arguments which are as- 
sumed to constitute a command to be timed. In 
this case the output is as follows: 



tim 
ovh 
swp 
dsk 
idl 
usr 



2.7 
0.3 
0.5 
1.8 
0.0 
0.0 



The given times represent the number of seconds 
spent in each category during execution of the 
command . 

/tmp/ttmp, /dev/rfO (for absolute timesO ~££ nS 
the information used to calculate the differ en 
tial times. 



file system(V) 

"9" if the command cannot be executed; >*"'%__, 
^; eat temp file" if trouble with ttmp; cant read 
super-b"ck" if times cannot be read from system. 

( 1 ) when invoked with a command argument , 
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TM (I) 
3/15/72 

evervthing going on at the moment is counted, not 
lust the command itself. (2) Two users doing tm 
simultaneously interfere with each other s use of 
the temporary file. 

OWNER Ken, dror 



- 2 - 



3/15/72 

NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



TSS (I) 

tss — interface to Honeywell TSS 

tss 

tss will call the Honeywell 6070 on the 201 data 

^ rl «111 then go into direct access with 

;23 a ;^°sr.tS3.i3 p f„pSrsJS ^ ^ 

conventions. 

j -i ucrTT nET.) is transmitted as 
An interrupt signal (ASCII del; 

a "break" to TSS. 

Xnput lines ginning ^,^^^1 ™ 

Z^rTrZTetll —d^o^ne* interface routine. 

~<file insert input from named UNIX file 

~>file deliver tss output to named UNIX file 

~p pop the output file 

~q disconnect from tss (quit) 

~ r file receive from HIS routine CSR/DACCOPY 

~ s file send file to HIS routine CSR/DACCOPY 

^ ~*. ^-FfHr-lpntlv transmitted 

Ascii files may be ™%?/ltccZ£ in this 
UE inq the HIS routine CSR/DAccuf - 

AFTname is the 6070 rue 

SYSTEM? CSR/DACCOPY (s) AFTname 
S^d^Encoded^File s file 

SYSTEM? CSR/DACCOPY (r) AFTname 
P^T^pjFn coded File r file 

/dev/dnO, /dev/dpO 

DONE when communication is brofcen. 

When diagnostic problems occur, tss exits rather 

abruptly* 

csr 
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NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



get tty name 



tty - 

* «-v,o iter's typewriter in 
name is then "/dev/ttyn . 



"not a tty" if the standard input file is not a 
typewriter. 



dmr, Ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



TYPE (I) 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



type on single sheet paper 



type - 

type name* ... 

type copys its input files to the standard out- 
put? After every 66 lines, type stops and reads 
the standard input for a new line character be- 
fore continuing. This allows time for insertion 
of single sheet paper. 



dmr 
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SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



UMOUNT (I) 

umount - dismount file system 

/gj-c /umount special 

^ *« the svstem that the removable 
f^y^r^evious^ounted on special file 
special is to be removed. 

„.,, j csue this command . 
Only the super-user may issue 

mount ( I ) 

^is command is not, in fact, restricted to the 
super -user. 

ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



un 



undefined symbols 



un [ name ] 

«.<«*• a a list of undefined symbols from an 
un prints a list <->j- file arqument is 

"aisembly or loader run If «£ a "t 9^ ^ 

S^SS*^* Sfr^esl have t.elr first 
character underlined. 

a. out 
as(l), ld(l) 



?" if the file cannot be found. 



dmr, ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



WC 



__ get (English) word count 



wc name,j • . • 

wc provides a count of the words, text lines, end 

Iff? control lines for each argument file. 

A text line is a s^uence of characters^ot^e^ 

con?^ "line is a^ne ginning hounded h, the 

ginning of^Unef hfthf ^ . line, « hy 

a blank or a tab. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



roff(l) 

none; arguments not found are ignored. 



jfo 
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NAME 

SYNOPSIS 

DESCRIPTION 



WHO ( I) 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



who 



who is on the system 



who [ who-f ile ] 

who without an argument, lists the name, type- 
writer cS el, and login time for each current 
UNIX user. 

Without an argument, who examines the /|m^|SlE 
file to obtain its information. If a file is 
„;;' that file is examined. Typically the 
riven* file will *« /Wwt»P . which contains a 
g Yf~* ij „n the loains since it was created. 
^wno^m lEt'Sl logins ana logouts since 
the creation of the wtmp file. 

/tmp/utmp 

login (I), init(VIl) 

"?" if a named file cannot be read. 

dmr, ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



WRITE (I) 



FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 
OWNER 



write — write to another user 



write user 

write copies lines from your typewriter to that 
3f~a^other user. When first called, write sends 
the message 

message from yourname... 

The recipient of the message should write back at 
this point. Communication continues until an end 
of file is read from the typewriter or an inter- 
rupt is sent. At that point write writes EOT 
on the other terminal. 

Permission to write may be denied or granted by 
He of the mesa command. At the outset writing 
is allowed .—Certain commands, in particular roff 
and pr, disallow messages in order to prevent 
messy output. 

tf the character "l" is found at the beginning of 
f linL wrige calls the mini-shell msh to execute 
the rest of the line as a command. 

The following protocol' is suggested for using 
write: When you first write to another user wax t 

f^Thim to write back before startin ^°/^' 
Each party should end each message with a dis- 
tinctive signal ("(o)" for °ver is convention- 
al) that the other may reply. (oo) (for over 
and out" ) is suggested when conversation is about 
to be terminated. 



/tmp/utmp 
/etc/rash 



to find user 
to execute ! 



mesg(l), msh(VIl) 

"user not logged in" ; "permission denied* 

dmr, ken 



- 1 - 
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BREAK (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



break — set program break 
sys break; addr / break = 17. 

b reak sets the system's idea of the highest loca- 
tion used by the program to addr. Locations 
greater than addr and below the stack pointer are 
not swapped and are thus liable to unexpected 
modification. 

An argument of is taken to mean 8K words. If 
the argument is higher than the stack pointer the 
entire user core area is swapped. 

When a program begins execution via exec the 
break is set at the highest location defined by 
the program and data storage areas. Ordinarily, 
therefore, only programs with growing data areas 
need to use break . 



FILES 

SEE ALSO 

DIAGNOSTICS 



exec (II) 

none; strange addresses cause the break to be set 
to include all of core. 



BUGS 
OWNER 



ken, dmr 
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CEMT (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



cemt 



— catch emt traps 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



sys cemt; arg / cemt = 29. 



This call allows one to catch traps resulting 
from Se emt instruction. Arg is a location 
within the~program; emt traps are sent to that 
location. The normal effect of |mt traps may be 
restored by giving an arg equal to 0. 

Prior to the use of this call, the result of an 
emt instruction is a ;i^«ted £tj xn.truction. 
The operand field is interpreted as a register, 
Int a? rts instruction is simulated ^ tMt 

stack or in a register. 



ken , dmr 
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3/15/72 

NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



change working directory 



chdir - 

sys chdir; dirname / chdir = 12. 

dirname is address of the pathname of a di recto- 
ry, terminated by a byte. chdir causes tnw 
directory to become the current working directo 
ry. 



chdir ( I ) 

The error bit (c-bit) is set if the given name is 

not that of a directory. 



ken , dmr 
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NAME chmod — change mode of file 

SYNOPSIS sys chmod; name; mode / chmod = 15. 

inscription The file whose name is given as the o nu ^~ s mode 

DESCRIPTION terminated s tring pointed to by £amj has its mode 

changed to mode. Modes are constructed by or ing 
?oS?her somT^ombination of the following: 

01 write, non-owner 

02 read, non-owner 
04 write, owner 

10 read, owner 

20 executable 

40 set user ID on execution 

Only the owner of a file (or the super-user) may 
change the mode. 

FILES 

SEE ALSO chmod(l) 

v.4- f« v,i i-^ set if name cannot be found or 
AGNOSTICS ;f£r££ t ( £« *i. S neithe7-the owner of the file 

nor the super-user* 

BUGS 

OWNER ken f dmr 



3/15/72 



CHOWN (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



chown — change owner of file 

sys chown; name; owner / chown =16. 

The file whose name is given by the null- 
termina?ed string pointed to by name has its own- 
er changed to owSer. Only the present owner of a 
file (or the super-user) may donate the file to 
an^her^user. Also, one -y not ch ^th^ojnjr 
of a file with the set-user-ID bit on, otherwise 
one could create Trojan Horses able to misuse 
other's files. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



chown(l), uids(V) 



The error bit (c-bit) is set on illegal owner 
changes* 



ken f dmr 
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NAME 
SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



CLOSE (II) 



close — close a file 

(file descriptor in rO) 
sys close / close = 6. 

Given a file descriptor such as returned from an 
open or creat call, close closes the associated 
file. A close of all files is automatic on exit, 
but since processes are limited to 10 simultane- 
ously open files, close is necessary to programs 
which deal with many files. 



creat (II), open ( II ) 

The error bit (c-bit) is set for an unknown file 
descriptor. 

ken , dmr 
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CREAT (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



cr 



ea t — create a new file 



/ creat = 8, 



sys creat; name; mode 

(file descriptor in rO) 

It rSSE2.riin.t- string If the f 11. did not 

PYist it is given mode mode; if it did exist, 
Si mode and owner remain unchanged but it is 
truncated to length. 

The file is also opened for writing, and its file 
descriptor is returned in rO. 

The mode given is arbitrary; it need not allow 
writing? This feature is used by programs which 
deal wiih temporary files of fixed names The 
creation is done with a mode that forbids writ 
ina Then if a second instance of the program 
Lptsa ireat, an error is returned and the 
program knowT^hat the name is unusable for the 
moment. 

t? the last link to an open file is. removed, the 
file Is not destroyed until the file is closed. 



FILES 

SEE ALSO 

DIAGNOSTICS 



BUGS 
OWNER 



write(Il), close(Il) 

The error bit (c-bit) may be set if: a needed 
directory is not readable; the file does not 
exist and the directory in which it is to oe 
TrelteTis not writable; the f 11. does ex.st and 
is unwritable; the file is a directory. 



ken f dmr 
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EXEC (II) 



NAME exec — execute a file 

SYNOPSIS sys exec; name; args / exec 

• • • 
name: <...\0> 

» • • _ 

args: argl ; arg2; ...» ° 

argl: <...\0> 



= 11 



DESCRIPTION 



exec overlays the calling process with the named 
fill then transfers to the beginning of the core 
file, then trans argument to exec xs 

^pointer to fne'namfof the fill to be executed. 

^U^l^ SEE. 1 : SrinTte?mi^ed 

by a null byte* 

There can be no return from the file; the calling 

core image is lost. 

The program break is set from the executed file; 

see the format of a. out. 

strings • 



sp-> 



nargs 
argl 
• • • 
argn 



argl : <arg1\0> 

• • ♦ 

argn: <argn\0> 
The arguments are placed as high as possible in 
core: Just below 60000(8). 

Files remain open across exec "^ s ' interrupt 
values! (See ilcjins, cemt, suit, intr. ) 

the system; the effective ID ^ermines his *c 

cess Jrivilf....) BSB 2S^ Stll « t£ *" e 
Ss^he^ser-Sel^B-^a^^fhe'rea! user IB is 

not affected. 



EXEC (II) 
3/15/72 

FILES 

SEE ALSO fork (II) 

nT^Nn^Trs If the file cannot be read or if it is not exe- 
DIAGNOSTICS ^^ \ return fr0 m exec constitutes the diag- 
nostic. The error bit (c-bit) is set. 

BUGS — 

OWNER ken, dmr 
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EXIT (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



exit 



terminate process 



(status in rO) 

sys exit / exit = 1 

exit is the normal means of terminating a pro- 
^iil. All files are closed and the parent pro- 
cess is notified if it is executing a wait. The 
low byte of rO is available as status to the 
parent process. 

This call can never return. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



wait(ll) 



ken, dmr 
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FORK (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



fork 



spawn new process 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



sys fork / fork = 2. 
(new process return) 
(old process return) 

fork is the only way new processes are « e ^ed. 
The~new process's core image is a copy of that of 
the caller of fork; the only distinction is the 
return loca?ion-iHd the fact that rO in the old 
pocess contains the process ID of the new pro- 
cess. This process ID is used by wait. 



wait (II), exec (II) 

The error bit (c-bit) is set in the old process 

I? a new process could not be created because of 

lack of process space. 

See wait (II) for a subtle bug in process destruc- 

tion. 



OWNER 



ken , drar 
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NAME 
SYNOPSIS 

DESCRIPTION 



FSTAT (II) 



fstat — get status of open file 

(file descriptor in rO) 

sys fstat; buf / fstat = 28. 

This call is identical to stat . except that it 
operates on open files instead of files ;£«* 
name It is most often used to get the status or 
^standard input and output files, whose names 
are unknown. \ 



FILES 

SEE ALSO 

DIAGNOSTICS 



stat (II) 

The error bit (c-bit) is set if the file descrip- 

tor is unknown. 



BUGS 
OWN HI 



ken f dmr 
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GETUID (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



getuid 



get user identification 



FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 
OWNER 



sys getuid / getuid = 24. 
(user ID in rO) 

getuid returns the real user ID of the current 
process. The real user ID identifies the person 
who is logged in, in contradistinction to the 
effective user ID, which determines his access 
permission at each moment. It is^thus useful^to 
programs which operate using the set user ID 
mode, to find out who invoked them. 

/etc/uids can be used to map the user ID number 
into a name. 

setuid(Il) 



ken, dmr 
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NAME 



gtty — get typewriter status 



SYNOPSIS (file descriptor in rO) 

sys gtty; arg / gtty = 32. 

• • • 

arg: .=.+6 

DESCRIPTION gtty stores in the three words addressed by ar£ 
DESCRIPTION g__Y. status of the typewriter whose file descrip- 
tor is given in rO. The format is the same as 
that passed by stty . 

FILES 
1 SEE ALSO stty (II) 

DIAGNOSTICS Error bit (c-bit) is set if the file descriptor 

does not refer to a typewriter. 

BUGS 

OWNER ken, dmr 



3/15/72 



HOG (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



hog — set program in low priority 
sys hog / hog = 34. 

The currently executing process is set into the 
lowest Priority execution queue. Background jobs 
t£at execute avery long time should do this. A 
hiaherpriority will be reinstituted as soon as 
the process ^dismissed for any reason other 
than quantum overflow. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



ken, dmr 
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ILGINS (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



ilgins — catch illegal instruction trap 
sys ilgins; arg / ilgins = 33. 

i lains allows a program to catch illegal instruc- 
tion traps. If arg is zero, the normal instruc- 
tion trap handling is done: the process is ter- 
minated and a core image is produced. If arg is 
a location within the program, control is passed 
to arg when the trap occurs. 

This call is used to implement the floating point 
simulator, which catches and interprets 11/45 
floating point instructions. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



fptrap(IIl) 



ken , dmr 
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INTR (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



intr 



set interrupt handling 



sys intr; arg / intr = 27. 



When arg is 0, interrupts (ASCII DELETE) are 

ESryd? When gg i. 1 .^^r^W 

normal result, that is, rorce an zz±- 

i«? a location within the program, control is 

transferred to that location when an interrupt 

occurs. 

After an interrupt is caught, it is P°«"*J ££. 
resume execution by means of an ^ f fc u ti0 a { 

end of file. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



quit (II) 



It should be easier to resume after an interrupt, 
but I don't know how to make it work. 



OWNER 



ken , dmr 
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KILL (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



kill — destroy process 

(process number in rO) 

sys kill / kill = 37.; not in assembler 

kill destroys a process, given its process 
number. The process leaves a core image. 

This call is restricted to the super-user, and is 
intended only to kill an otherwise unstoppable 
process. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



c-bit set if user is not the super-user, or if 
process does not exist. 

ki H has been known to be ineffective, 
ken, dmr 



3/15/72 



LINK (II) 



I * 



NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 



BUGS 
OWNER 



link — link to a file 

sys link; name^ narae 2 / link = 9. 

A link to name is created; the link has name 
name ,. Either name may be an arbitrary path 
name. 



link(l), unlink(ll) 

The error bit (c-bit) is set when name,, cannot be 
found; when name , already exists; when the direc- 
tory of name , cannot be written; when an attempt 
is made tolink to a directory by a user other 
than the super-user. 



ken , dmr 
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MAKDIR (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



makdir — make a directory 

sys makdir; name; mode / makdir =14. 

makdir creates an empty directory whose name is 
"the null-terminated string pointed toby GJffif • 
The mode of the directory is mode. The special 
entries "." and ".. are not present. 

makdir can only be invoked by the super -user. 



FILES 

SEE ALSO 

DIAGNOSTICS 



mkdir(l) 

Error bit (c-bit) is set if the directory already 

exists or if the user is not the super-user. 



BUGS 
OWNER 



ken , dmr 
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MDATE (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



mdate 



set modified date on file 



(time to AC-MQ) 

sys mdate; file / mdate = 30. 

File i S the address of a null-terminated string 

gTving the name of a file. The modified time of 

the file is set to the time given in the AC-MQ 
registers. 

This call is allowed only to the super-user or to 
the owner of the file. 



FILES 

SEE ALSO 

DIAGNOSTICS 



Error bit is set if the user is not the super- 
user or if the file cannot be found. 



BUGS 
OWNER 



ken , dmr 
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MOUNT (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



mount 



— mount file system 



sys mount; special; name / mount = 21. 

mount announces to the system that a removable 
filT"system has been mounted on special file 
special; from now on, references to file HSm 
Sifl^ifer to the root file on the newly mounted 
file svstem. Special and name are pointers to 
nuU^mfnlted^stHKgs containing the appropri- 
ate path names. 

Name must exist already. If it had usef «1 con- 
^n~Es, they are inaccessible while the file sys 
tern is mounted. 

Almost always, name should be a directory so that 
an entire file system, not just one file, may 
exist on the removable device. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



mount(l), umount(Il) 



Error bit (c-bit) set if special is inaccessible 
or dir does not exist. 

At most two removable devices can be mounted at a 
time? Tne use of this call should be restricted 
to the super-user* 



OWNER 



ken , dmr 
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OPEN (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



open — open for reading or writing 

sys open; name; mode / open = 5. 
(descriptor in rO) 

open opens the file name for reading (i^ffiajs is 
0)or writing (if mode is non-zero), name is the 
address of a string of ASCII characters 
representing a path name, terminated by a null 
character. 

The file descriptor should be saved for subse- 
quent calls to read (or write) and close. 

In both the read and write case the file pointer 
is set to the beginning of the file. 

If the last link to an open file is removed, the 
file is not destroyed until it is closed. 



FILES 

SEE ALSO 

DIAGNOSTICS 



creat(ll), read(ll), write(Il), close(Il) 

The error bit (c-bit) is set if the file does not 
exist, If one of the necessary directories does 
not eiist or is unreadable, or if the file is not 
readable. 



BUGS 
OWNER 



ken f dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



— turn off quit signal 
quit; flag / quit = 26. 



QUIT (II) 



quit 

sys 

When flag is 0, this call disables quit signals 
from ^typewriter (ASCII FS). When flja " L 
quits are re-enabled, and cause fecutlonto 
cease and a core image to be produced. When f±as 
is an address in the program, a quit causes con- 
trol to be sent to that address. 

Quits should be turned off only with due con- 
sideration. 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 



intr(Il) 



ken , dmr 
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READ (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



read — read from file 

(file descriptor in rO) 

sys read; buffer; nchars / read = 3. 

(nread in rO) 

A file descriptor is a word returned from a suc- 
cessful open call. 

Buffer is the location of nchap contiguous bytes 
intc"which the input will be placed. It is not 
guaranteed that all nchars bytes will be read, 
however; for example if the file refers to a 
typewriter at mos? one line will be returned 
any event the number of characters read is re 
turned in rO. 

If rO returns with value 0, then end-of-f ile has 
been reached. 



In 



FILES 

SEE ALSO 

DIAGNOSTICS 



open (II) 

As mentioned, rO is v***™"*™^™* ° f 
the file has been reached. If the read was 
otherwise unsuccessful the error bit (c-bit) is 
set Many conditions, all rare, can generate an 
eJror: physical i/o errors, bad buffer address, 
preposterous nchars, file descriptor not that of 
an input file. 



BUGS 
OWNER 



ken f dmr 
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RELE (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



rele — release processor 

sys rele / rele =0; not in assembler 

This call causes the process to be swapped out 
immediately if another process wants to run. Its 
main reason for being is internal to the system, 
namely to implement timer-runout swaps. However, 
it can be used beneficially by programs which 
wish to loop for some reason without consuming 
more processor time than necessary. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



ken , dmr 
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SEEK (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



seek — move read/write pointer 

(file descriptor in rO) 

sys seek; offset; ptrname / seek = 19. 

The file descriptor refers to a file open for 
reading or writing. The read (or write) pointer 
for the file is set as follows: 

if ptrname is 0, the pointer is set to offset, 

if Ptrname is 1 , the pointer is set to its 
current location plus offset . 

if ptrname is 2, the pointer is set to the 
size of the file plus offset. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



tell (II) 

The error bit (e-bit) is set for an undefined 
file descriptor. 

A file can conceptually be as large as 2**20 
bvtes. Clearly only 2**16 bytes can be addressed 
by seek . The problem is most acute on the tape 
files~and RK and RF. Something is going to be 
done about this. 



OWNER 



ken , dmr 
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SETUID (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



setuid 



set process ID 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



(process ID in rO) 

sys setuid / setuid = 23. 

The user ID of the current process is set to the 
argument in rO. Both the effective and the real 
user ID are set. This call is only permitted to 
the super-user or if rO is the real user ID. 



getuid(ll) 

Error bit (c-bit) is set if the current user ID 
is not that of the super-user. 



ken , dmr 
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NAME 



sleep — stop execution for interval 



SYNOPSIS (60ths of a second in rO) 

sys sleep / sleep = 35.; not in assembler 

DESCRIPTION The current process is suspended from execution 

for the number of 60ths of a second specified by 
the contents of register 0. 

FILES 
SEE ALSO 
DIAGNOSTICS — 

BUGS Due to the implementation, the sleep interval is 

only accurate to 256 60ths of a second (4.26 
sec). Even then, the process is placed on a low 
priority queue and must be scheduled. 

OWNER ken, dmr 
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STAT (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



stat — get file status 

sys stat; name; buf / stat = 18. 

name points to a null-terminated string naming a 
file; buf is the address of a 34(10) byte buffer 
into which information is placed concerning the 
file. It is unnecessary to have any permissions 
at all with respect to the file, but all direc- 
tories leading to the file must be readable. 

After stat . buf has the following format: 



buf, +1 
+2, + 3 
+4 
+5 

+6, +7 
+8, + 9 



i-n umber 

flags (see below) 

number of links 

user ID of owner 

size in bytes 

first indirect block or contents block 



+22, +23 eighth indirect block or contents block 

+24^+25, +26, +27 creation time 
+28, +29, +30, +31 modification time 
+32, +33 unused 

The flags are as follows: 

100000 used (always on) 

040000 directory 

020000 file has been modified (always on) 

010000 large file 

000040 set user ID 

000020 executable 

000010 read, owner 

000004 write, owner 

000002 read, non-owner 

000001 write, non-owner 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



stat(I), fstat(ll) 

Error bit (c-bit) is set if the file cannot be 
found. 

The format is going to change someday, 
ken, dmr 
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STIME (II) 



NAME 
SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



stime 



set time 



(time in AC-MQ) 

sys stime / stime = 25. 

stime sets the system's idea of the time and 
date. Only the super-user may use this call. 



date(l), time(ll) 

Error bit (c-bit) set if user is not the super- 
user. 



ken , dmr 
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NAME 
SYNOPSIS 

args 
DESCRIPTION 



STTY (II) 



stty 



— set mode of typewriter 



(file descriptor in rO) 
sys stty; arg / stty =31. 

dcrsr; dcpsr; mode 

sttv sets mode bits for a typewriter whose file 
!iicr?ptor is passed in rO. First, ^system 
dSlavs until the typewriter is quiescent. Then, 
the l%Zlnt dcrsr is placed into the typewri- 
ter's ?eceivelTc^ntrol and status register, and 
dcLJ is placed in the transmitter control and 
?SS S reaister. The DC-11 manual must be con 
?*2 5S the format of these words. For^the 
suited for Jhe tormax: important role of 

?nere S ar gumeni S s ifto adjust to tne speed of the 

typewriter. 

The mode arguments contains several bits which 

deterge the system's treatment of the 

typewriter: 

200 even parity allowed on input (e. g. for m37s) 
100 odd parity allowed on ^^^ _ ters 

r* ^rip«=-- — - *»*« <•• '• m33) 

002 echo and print tabs as spaces 

001 inhibit all function delays (e. g. CRTsj 

Characters with the wrong parity. " determined 

by bits 200 and 100, are ignored. 

in raw mode, every character is passed back im-_ 

TefsSf Is^fet ^re^o/-?^ 

the interrupt character (DELETE) and the quit 

Saracter (FS) are not treated specially. 

Mode 020 causes input carriage returns to be 
turned into new-lines; input of either CR ° r " _ 

*,=L tp-CR both to be echoed (used for GE Ter 
Set 300^ anS other terminals without the new- 
line function)* 

Z?^iTs™?™™™«-° *p^ " 41 modes - 

These mode bits are: 



tZ m 2lS Ji."^r»-it interrupt feature 
2 000 usf^rrelponoe'ncl^e conversion on outp.t 



400 
1000 



6/12/72 STTY (II) 

4000 use correspondence code conversion on input 
(currently ignored) 

Normal input and output code conversion for 2741s 
is EBCDIC (e. g. 963 ball and corresponding key- 
board). The presence of the transmit interrupt 
feature permits the system to do read-ahead while 
no output is in progress. In 2741 mode, the low 
order bits 331 are ignored. 

FILES 

SEE ALSO stty(l), gtty(ll) 

DIAGNOSTICS The error bit (c-bit) is set if the file descrip- 
tor does not refer to a typewriter. 

BUGS This call should be used with care. It is all 

too easy to turn off your typewriter. 

OWNER ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



SYNC (II) 



sync — update super-block 

sys sync / sync = 36.; not in assembler 

sync causes the super block for all file systems 
£Tbe written out. It is only necess ary on sys- 
tems in which this writing may be delayed for a 
long time, i.e., those which incorporate hardware 
protection facilities. 

It should be used by programs which examine a 
file system, for example check, df, tm, etc. 



ken 



_ 1 — 
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TELL (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



tell — get file pointer 

(file descriptor in rO) 

sys tell; offset; ptrname / tell = 20. 

(value returned in rO) 

The file descriptor refers to an open file. The 
value returned in rO is one of: 

if ptrname is 0, the value returned is offset; 

if ptrname is 1 , the value is the current 
pointer plus o ffset ; 

if ptrname is 2, the value returned is the 
number of bytes in the file plus offset. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



seek (II) 

The error bit (c-bit) is set if the file descrip- 
tor is unknown. 

Tell doesn't work. Complain if you need it. 
ken, dmr 
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NAME 
SYNOPSIS 

DESCRIPTION 



TIME (II) 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



time 



— get time of year 



sys time / time =13. 
(time AC-MQ) 

time returns the time since 00:00:00, *«• *• 
T97T, measured in sixtieths of a second. The 
high order word is in the AC register and the low 
order is in the MQ. 



date(l), stime(ll) 



The chronological-minded user will note that 
2**32 sixtieths of a second is only about 2.5 
years. 



OWNER 



ken f dmr 
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UMOUNT (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



umount — dismount file system 
sys umount; special / umount = 22. 

umount announces to the system that special file 
special is no longer to contain a removable file 
system. The file associated with the special 
file reverts to its ordinary interpretation (see 
mount ). 

The user must take care that all activity on the 
file system has ceased. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



umount(l), mount (II) 

Error bit (c-bit) set if no file system was 
mounted on the special file. 

Use of this call should be restricted to the 
super-user. 



OWNER 



ken, dmr 
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UNLINK (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



un 



link — remove directory entry 



FILES 

SEE ALSO 

DIAGNOSTICS 



BUGS 



sys unlink; name / unlink = 10. 

Name points to a null-terminated string. Unlink 
Fi^oves the entry for the file pointed to by name 
from its directory. If this entry was the last 
link to the file, the contents of the file are 
freed and the file is destroyed. If, however, 
the file was open in any process, the actual des- 
truction is delayed until it is closed, even 
though the directory entry has disappeared. 



rm(I), rmdir(l), link(ll) 

The error bit (c-bit) is set to indicate that the 
file does not exist or that its directory cannot 
be written. Write permission is not required on 
the file itself. It is also illegal to unlink a 
directory (except for the super -user). 

Probably write permission should be required to 
remove Ihe last link to a file, but this gets in 
other problems (namely, one can donate an un- 
deletable file to someone else). 

If the system crashes while a file is waiting to 
be deleted because it is open, the space is lost. 



OWNER 



ken , dmr 
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WAIT (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



wait — wait for process to die 

sys wait / wait = 7. 

(process ID in rO) 

(termination status/user status in MQ) 

wait causes its caller to delay until one of its 
child processes terminates. If any child has 
already died, return is immediate; if there are 
no children, return is immediate with the error 
bit set. In the case of several children several 
wait s are needed to learn of all the deaths. 

If the error bit is not set on return, the MQ 
high byte contains the low byte of the child pro- 
cess rO when it terminated. The MQ low byte con- 
tains the termination status of the process from 
the following lists 

exit 

1 bus error 

2 trace trap 

3 illegal instruction 

4 IOT trap 

5 power fail trap 

6 EMT trap 

7 bad system call 

8 quit 

9 interrupt 

10 kill (see kill (II)) 
+16 core image produced 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



exit (II), fork(Il) 

error bit (c-bit) on if no children not previous- 
ly waited for. 

A child which dies but is never waited for is not 
really gone in that it still consumes disk swap 
and system table space. This can make it impos- 
sible to create new processes. The bug can be 
noticed when several "sT separators are given to 
the shell not followed by a command without an 
ampersand. Ordinarily things clean themselves up 
when an ordinary command is typed, but it is pos 
sible to get into a situation in which no com- 
mands are accepted, so no wait s are done; the 
system is then hung. 

The fix, probably, is to have a new kind of fork 
which creates a process for which no wait is 
necessary (or possible); also to limit the number 
of active or inactive descendants allowed to a 
proc 3ss. 



3/15/72 

NAME 
SYNOPSIS 

DESCRIPTION 



WRITE (II) 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



/ write = 4. 



write — write on file 

(file descriptor in rO) 
sys write; buffer; nchars 
(number written in rO) 

A file descriptor is a word returned from a suc- 
cessful open or creat call. 

*,'i*^r is the address of nchars contiguous bytes 
Mcfare written on the output file. The number 
of characters actually written is ^turned in rO. 
It should be regarded as an error if this is not 
the same as requested. 

For disk and tape files, writes which are multi- 
tiM of 512 characters long and begin on a 
Il2-byte boundary are more efficient than any 
others. 



creat (II), open (II) 

The error bit (c-bit) is set on an error: bad 
descriptor, buffer address, or count, physical 
I/O errors; 



ken f dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



ATAN, ATAN2 (ill) 



atan — arc tangent function 
jsr r5,atan[2] 

The atan entry returns the arc tangent of frO in 
frO. The range is zero to pi/2. The atan2 entry 
returns the arc tangent of fr0/fr1 in frO. The 
range is -pi to pi. The floating point simula- 
tion should be active in either floating or dou- 
ble mode, but in single precision integer mode. 



kept in /usr/lib/liba. a 
fptrap(lll) 



rhm, dmr, ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



ATOF (III) 



atof — ascii to floating 
jsr r 5, atof; subr 

atof will convert an ascii stream to a floating 
SSlef returned in frO The subroutine |g| is 
called on r5 for each character of the ascii 
stream. subr should return the 
The first character not used m 
left in rO. The floating point 
be active in either floating or 



character in rO. 
the conversion is 
simulation should 
double mode, but 



in single precision integer 
kept in /usr/lib/liba.a 



mode. 



fptrap(IH) 

The subroutine subr should not disturb any regis- 
ters. 

ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



ATOI (III) 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



atoi __ ascii to integer 



Jsr 



r 5, atoi; subr 



atoi will convert an ascii stream to a binary 
HuSer returned in mq. The subroutine jag i. 
„ llpd on r 5 for each character of the ascii 

?ii»m subr should return the character in rO. 
?he e ?Trst^lrac?er not used in the conversion x. 
left in rO. 
kept in /usr/lib/liba.a 



The 
ters 

ken 



subroutine subr should not disturb any regis- 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



CONST (III) 



con 



st floating point constants 



The following floating point constants are 
correctly represented in double precision. 



one 
pi2 



1.0 
0.5*3.1415... 



kept in /usr/lib/liba.a 
fptrap(IH) 



rhm, dmr, ken 
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NAME 
SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



CTIME (III) 



ctime — convert date and time to ASCII 

(move time to AC-MQ) 
mov $buffer,rO 
jsr pc, ctime 

The buffer is 15 characters long. The time has 
the format 

Oct 9 17:32:24 

The input time is in the AC and MQ registers in 
the form returned by sys time. 

kept in /usr/lib/liba. a 
ptime(lll), time (II) 



dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



exp 



exponential function 
r5,exp 



-„*.4»i of frO is returned in frO. The 
The exponential or rru i active in 

precision integer mode, 
kept in /usr/lib/liba.a 

fptrap(IH) 

The c-bit is set if the result is not represent- 

able. 



rhm, dmr, Ken 
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NAME 
SYNOPSIS 

DESCRIPTION 



fptrap 



FPTRAP (III) 



PDP-11/45 floating point simulator 



.globl fptrap 

sys ilgins; fptrap 

• „ nark , ae which picks up instructions 

fjgtrap is a f* ck f g * " ^ne PDP-11/20, and if they 
which are illegal for the PDP^V t » nstructions , 

C s i m ura P tefth ei 1 r 1 ^eraSon. \% following in- 
structions are supported: 

cfcc 

setf 

seti 

setd 

setl 

clrf 

tstf 

absf 

negf 

mulf 

modf 

addf 
movf 

movf 

subf 

cmpf 

divf 

movf i 

movif 

movfo 

movof 



fdst 
f src 
fdst 
fdst 
fsrc,fr 
fsrc,fr 
fsrc.fr 
fsrc.fr (= 
fr.fdst ( = 
fsrc.fr 
fsrc.fr 
fsrc.fr 
fr.dst ( = 
src.fr {■ 
fr.fdst ( 
fsrc.fr ( 



ddf) 

:Stf ) 



:StCfi) 

=ldcif ) 
=stcxy) 
=ldcyx) 



Here src and ft«^J? l0 ^^"%?lls- 
tion. f^rca^d|d|| for float i ^ l8ter . Notice 
tination, and trior zxua y * opC odes have 
that the names of s ^J^ e °J n ^uc?!on is movf . 
changed, f ??^ t f ^fL Source operand is a 
which turns into sti " -"-J- 1( , f ^ not . 
floating register, and into ldf if not. 

set the fee on stf. 

„ i™« -Format for both floating point 
Short and long format ,^„" rted# Truncation 
numbers and integers is supported. flow and 

The condition code bit, are maintained correctly. 

For floating-point —« "H^Je^f "" 
mode ((pc)-O ia not supported, since 

- 1 - 
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FPTRAP (III) 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



PDP-11/45 handbook is not clear on what to do 
about it. 

After an arithmetic error the result is generally 
meaningless. 

The arithmetic is always done ^ /ouble- 
precision, so exact but unrounded results are to 
be expected in single-precision mode. Double 
precision results are probably less correct than 
the hardware will be. 

The lower parts of the floating registers become 
meaningless during single-precision operations. 

kept in /usr/lib/liba.a 

PDP-11/45 handbook, ilgins(Il) 

trap, c-bit, v-bit 

see above 

ken , dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



— floating to ascii conversion 



ftoa 

jsr r 5, ftoa; subr 

CS, ,1U convert the £^ d ffi53^-]«'. 

Th °e rloatfn f oint^atoUn ould £ active in 

either f lo^^," rch'chartcterleneratel by 

r t ^ er the t: b rourinrkr i= called on register 

r5 with the character in rO. 

kept in /usr/lib/liba.a 
fptrap(IH) 

The subroutine subr should not disturb any regis- 

ters* 

ken 
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NAME 
SYNOPSIS 



DESCRIPTION 

FILES 

SEE ALSO 
DIAGNOSTICS 

BUGS 
OWNER 



CONNECT, GERTS (III) 

connect, gerts - Gerts communication over 201 

jsr r 5, connect 
(error return)/ 

• • • 

jsr r5, gerts; fe; oc; ibuf ; obuf 
(error return) 

• • • 

The GECOS GERTS interface is so bad th« a 

er. 

/dev/dnO , /dev/dpO 
kept in /usr/lib/Hba.a 



dn(lV), dp (IV), "HIS documentation 



ken 
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NAME 
SYNOPSIS 



GETC, GETW, FOP EN (III) 



DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



getw, getc, fopen 



— buffered input 



mov 
jsr 



$filename,rO 
r 5, fopen; iobuf 



jsr r 5, getc; iobuf 
(character in rO) 

jsr r 5, getw; iobuf 
(word in rO) 

These routines are used to provide a buffered 
i™J £»rilitv. iobuf is the address of a 
5ll( 10) ^e buffiTIrea whose contents are re- 
tained by these routines. Its format is: 



ioptr: 



.=.+2 
. = .+2 
. = .+2 
. = .+512. 



/ file descriptor 
/ characters left in buffer 
/ ptr to next character 
/ the buffer 

fopen raay be called initially to open th e file. 

read from the standard input file. 

getc returns the next byte from the file in rO. 

ThTerror bit is set on end of file or a read 

error. 

aetw returns the next word in rO. g^ and aetw 

Sfbe used alternately; there are no odd/even 

problems* 

iobuf must be provided by the user; it must be on 

a word boundary. 

kept in /usr/lib/liba.a 

open (II), read (II), putc(lll) 

c-bit set on EOF or error 



dmr 
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NAME 
SYNOPSIS 

DESCRIPTION 



HYPOT (III) 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



hypot __ calculate hypotenuse 



(A in frO) 
(B in frO) 
jsr r 5, hypot 

The square root of frO*frO + £r1*fr1 is returned 
Tn f JS The calculation is done in such a way 
that overf low will not occur unless the answer is 
not representable in floating point. 

The floating point simulator should be active in 
either single or double mode. 

kept in /usr/lib/liba.a 

fptrap(IH) 

The c-bit is set if the result cannot be 
represented. 



ken f drar 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



itoa 



Jsr 



—integer to ascii conversion 
r 5, itoa; subr 



decimal possibly P^cedea oy su J r outine subr 

Tumi ir/ e Tsi^rd^L s tT^ — 

rO. 

kept in /usr/lib/liba.a 



The 
ters. 

ken 



subroutine subr should not disturb any regis- 
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LOG (III) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



log — logarithm base e 
jsr r5,log 

The logarithm base e of frO is returned in frO. 
The floating point simulation should be active in 
either floating or double mode, but in single 
precision integer mode. 

kept in /usr/lib/liba. a 

fptrap 4 

The error bit (c-bit) is set if the input argu- 
ment is less than or egual to zero. 



ken 
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NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



MESG (III) 

mesg _ write message on typewriter 

jsr r 5, mesg; <Now is the time\0>; .even 

mesg writes the string immediately ^"f^^ 8 
"ZZu. onto the standard output file. The string 
is terminated by a byte. 



kept in /usr/lib/liba.a 



ken , dmr 
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NAME 
SYNOPSIS 



NLIST (III) 



nlist — get entries from name list 
jsr r5, nlist; file; list 

• • • 

file: <file name\0> 

list: 

<name1xxx>; typel ; valuel 
<name2xxx>; type2; value2 



DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



nlist will examine the name list in an assembler 
^t file and selectively extract a list of 
values. The file name is a standard UNIX path 
name. The name list consists of a list of 8- 
character names (null padded) each followed by 
two words. The list is terminated with a zero. 
Each name is looked up in the name list of the 
file. If the name is found, the type and value 
of the name are placed in the two words following 
the name. If the name is not found, the type 
entry is set to -1 . 

This subroutine is useful for examining the sys- 
tem name list kept in the file /sys/sys/unix. In 
this way programs can obtain system magic 
numbers that are up to date. 

kept in /usr/lib/liba. a 

a.out(V) 

All type entries are set to -1 if the file cannot 
be found or if it is not a valid namelist. 



BUGS 
OWNER 



ken 
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NAME 
SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



PTIME (III) 

ptime — print date and time 

(move time to ac-mq) 
moV file.rO 
jsr pc, ptime 

j^ prints th. date and time in the form 

Oct 9 17:20:33 

on the file whose file O"" 1 ^ 1 ^ "be""* 
ll^l,Vl^Ttr^T^l listers « 
?„e form returned by £££ time. 

Kept in /usr/lib/liba.a 

time(II), ctime(III) (used to do the oonversion) 



see ctime 
dmr, Ken 
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NAME 
SYNOPSIS 



PUTC, PUTW, FCREAT, FLUSH (III) 



DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



, putw, fcreat, flush - 

$f ilename,rO 

r 5, fcreat; iobuf 



- buffered output 



putc 

mov 
Jsr 

(get byte in rO) 

jsr r 5, putc; iobuf 

(get word in rO) 

jsr r 5, putw; iobuf 

jsr r 5, flush; iobuf 

to be writienTbut does not close the file. The 
format of the buffer is: 



iobuf : 



. = .+2 
. = .+2 
. = .+2 
.=.+512, 



/ file descriptor 
/ characters unused in buf£er 
/ ptr to next free character 
/ buffer 



turn error information. 

Before terminating, a program should call flush 

B t oforce out the last of the output. 

The user must supply iobuf, which should begin on 

a word boundary. 

kept in /usr/lib/liba.a 

creat(H), write(Il), getc(lll) 

error bit possible on fcreat call 



dmr 
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NAME 
SYNOPSIS 



DESCRIPTION 



QSORT (III) 



qsort — quicker sort 

(base of data in r1 ) 
( end of data in r2 ) 
(element width in r3) 
jsr pc, qsort 

SiS'lStog.* Reg?"e?s r1 and r2 delimit the 
l^toTof core containing the array of byte^ ^ 
strings to *r sort ^ : to \£ffirst location above 
the "rat string, f eg ^ t £%r contains the length 
the last r ?. r *f^ S s ^ u ! d be a multiple of 
of each string, ri ri sn MQ are 

r3. On return, rO, r1 , r2, ri, «, 
destroyed. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



The user should be able to supply his own compar- 
ison routine. 



OWNER 



ken 
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NAME 
SYNOPSIS 



SALLOC (III) 

salloc — string manipulation routines 

(get size in rO) 
jsr pc, allocate 

(get source pointer in rO, 
destination pointer in r1 ) 
jsr PC copy 

Jsr pc,wc 

(all following instructions assume r1 contains pointer) 

j sr pc, release 

(get character in rO) 
jsr pc, put char 

j sr pc t lookchar 

(character in rO) 

jsr pc,getchar 

(character in rO) 

(get character in rO) 
jsr pc, alter char 

(get position in rO) 
1 sr pc t seek char 

jsr pc, backspace 

(character in rO) 

(get word in rO) 
jsr pcputword 

jsr pc,lookword 

(word in rO) 

jsr pc, get word 

(word in rO) 

(get word in rO) 
jsr pc.alterword 

jsr pc,backword 

(word in rO) 

jsr pc, length 

(length in rO) 

jsr pc, posit ion 

(position in rO) 

jsr pc, rewind 
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SALLOC (III) 



6/15/72 



jsr pc, create 

jsr pc.fsfile 

jsr pc.zero 



words and bytes. The firings be 

Xsiaerakri-ert^ ^available core. 
For each string ^ere is a hea d r of four-rds, 
namely a write pointer, a read ^oin ^^ 

pointers to the ^^ nin ? n £i a u y the read and 
containing the string. Init *££ of the 

write pointers P°i n V?*»t refer to a string 
string! All routines that refer to the 

^msstf* L ir ^&r- r1 

to be be moved* 

releaS e releases . string ba=K to free storage. 

pointer • 

8*^S^dffB& r a M 3.S2 ST~ 

read pointer • 

pointer • 

.Prober -« «^^ "^^frS? 
"ilfinoS^ranl^vlnce the read pointer. 

' £a£ H SES£ e and ^K^-a th. jl-t byte or «ora 
written and decrement the write i~ 

All «rite «»P«rS. , eSi»rMSS 1 l? 1 ««2--- t 
larger block if the «*"££%£,.„ the error bit set 

S^XrLTtoTeaatSona the write pointer. 

seeKchar noves the read pointer to the offset 
specified in rO. 
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FILES 



SALLOC (III) 



go^itioa returns the current offset of the read 

pointer in rO. 

f-ewlnd moves the reed pointer to the current 

position of the write pointer. 

create returns the read and write pointers to the 

beginning of the string. 

^ copies the string *■»"• h £*«J 6 £ t £ r?. 1 " 
foto the string whose header ??f ^L^stric- 
care should be t^en in using » W of 

tion since rl will J^*£« *£ the destination 
the source string is Diyyc^ 

stringi 

&tttt£S?~ hf wrft^on SET 
The allocator proper is in /usr/Uc/alloc/allo=a. 

Tbe archive /usr/llc/alloc/allocb contains the 
Inoiviluarroutines discussed above. 

ailoc.d is the temporary file used to contain the 

strings. 



SEE ALSO 
DIAGNOSTICS 



- 4* » disk write error occurs dur- 
" error in copy if a disK wri tion . 

ing the execution of the copy instr caiied 

"error in allocator if ^y Jg£» output 

with a bad header pointer. J-a™ * 

file" if file a l loC ;L San i? there's no available 
opened: Out of space if ^ ere header s avail- 
block of the requested size or n 
able for a new block. 



BUGS 
OWNER 



llc,rhm 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 



SIN, COS (III) 



sin, cos — sine cosine 
jsr r5,sin (cos) 

The sine (cosine) of frO (radians) is returned in 
frO. The floating point simulation should be 
active in either floating or double ™**.*f in 
single precision integer mode. All floating 
registers are used. 



kept in /usr/lib/liba.a 
fptrap(IH) 



Size of the argument should be checked to make 
sure the result is meaningful. 

ken , dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



SQRT (III) 

sqrt — square root function 
jsr r 5, sqrt 

The square root of frO is returned in frO. The 
floating point simulation should be active in 
either floating or double mode, but in single 
precision integer mode. 

kept in /usr/lib/liba.a 

fptrap(IH) 

The c-bit is set on negative arguments. 

rhm, dmr, ken 
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NAME 



SWITCH (III) 



switch — switch on value 



SYNOPSIS (switch value in rO) 

jsr r 5, switch; swtab 
(not-found return) 

• • • 

swtab: vail ; labl ; 

• • • 

vain; labn 

..; o 

DESCRIPTION switch compares the value of rO against each of 
DESCKXfixujN match is found, control is 

transferred to the corresponding lab (after pop- 
UTa the stack once). If no match has been found 
by the time a null lab. occurs, switch returns. 

FILES kept in /usr/lib/liba.a 



SEE ALSO 
ni nr^NHSTTCS 




BUGS 


, — 


OWNER 


ken | dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



DNO (IV) 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



dnO — dn-11 ACU interface 



dnO is a write-only file. Bytes written on dnO. 
SSit be ASCII digits. Each digit corresponds to 
a digit of a telephone number to be called. me 
entire telephone number must be presented in a 
single write system call. The call must complete 
with the last digit. 

found in /dev 

dpO(IV), write(Il) 



ken , dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



DP (IV) 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 



dpO 



— dp-11 201 data-phone interface 



rir,n is a 201 data-phone interface file, read and 
ritrcalfs'to d^are limited to a .axi- of 

^r e %evLnirs i rror 1 e 1 ach S hrte t are written 
r a!ong ktHfeighth odd parity bit The sync 

bi?s are returned unaltered; the eighth bit is 
set if the byte was not received in odd parity. 
J 20 second time out is set and a zero byte 
record ^returned if nothing is received in that 

time. 

found in /dev 

dnO(IV), gerts(lll) 



The d£ file is GECOS oriented. It should be more 
flexible. 



ken , dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



LPR (IV) 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



/dev/lpr — line printer 



prinLr. The following special cases for the 
printer are handled: 

On opening and on closing, the paper is slewed 

to the top of the next page. 

For the 64 character printer (LP1 1-FA) , all 

lower case letters are converted to upper 

case. 

Tabs are converted to align on every eighth 

column* 

New lines and form feeds are ignored when the 

ll^ltl £ and^offou? ut iT»* ^eo^o* 
?he prinSr and-s^nc on page boundaries even 
with automatic page slew. 

Carriage return and back space can cause mul- 
tiple printing on a single line to allow 
overstruck graphics. 

found in /dev 



ken , dmr 
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MEM (IV) 



NAME 

SYNOPSIS 

DESCRIPTION 



mem 



core memory 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



mem maps the core memory of the computer into a 
file. It may be used, for example, to examine, 
and even to patch the system using the debugger. 

Mem is a byte-oriented file; its bytes are num- 
bered to 65,535. 

found in /dev 



OWNER 



If a location not corresponding to implemented 
memory is read or written, the system «£" «™ r 
a bus-error trap and, in panic, will reboot it 
self. 

ken, dmr 
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MTO (IV) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



OWNER 



mtO — magtape 



.to is the DEC TU10/TH11 magtape. When opejjed 
f3r reding or writing the » W^ a r rKoras 
A tape consists of a series o t x th 

terminated by an "V "«'«,««=* of a record 
256 b W ° r ianor 5 ed 2 TrltL™ tnanTrecord causes 
tC ,V e ilSTn^to 512 bytes. When the magtape is 
"closefart:! writlng^n e„d-of-file is written. 

q.ric has no effect on the magtape. The magtape 
can on?y be opened once at any instant. 

found in /dev 
mt(l) 



see* should worK on the magtape ^/.Jf * 
siting shoSd SlstTYmultl-f lie and multi- 
reel facility should be incorporated. 

ken , dmr 
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PPT (IV) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



ppt — punched paper tape 

ppt refers to the paper tape reader or punch, 
defending on whether it is read or written. 

When ppt is opened for writing, a 100-character 
leaderis punched. Thereafter each byte written 
Is punched P on the tape. No editing of the char- 
acters is performed. When the file is closed, a 
100-character trailer is punched. 

When opt is opened for reading, the process waits 
unTil^pe is P placed in the reader and the reader 
•ic? on-line. Then requests to read cause the 
characters read to £ passed back to the program, 
again without any editing. This means that 
several null characters will usually appear at 
IZ beginning of the file; they <~^spond to th e 
taDe leader. Likewise several nulls are HKf 1 * 
to P a PP ear ^ the end. End-of-f ile is generated 
when the tape runs. out. 

Seek calls for this file are meaningless and are 
effectively ignored (however, the read/write 
pointers are maintained and an arbitrary sequence 
of reads or writes intermixed with seeks will 
gLe apparently correct results when checked with 

tell ). 

found in /dev 



ken , dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



- RF11-RS11 fixed-head disk file 



rfO - 



This file refers to tj ; . J entire RI ^^ ^ 
be either read or written, Jitnoug 
inherently very dangerous, since am y 
resides there. 

, n , 4 o 56-word blocks, numbered 
The disk contains 1024 256-wora^ red dev _ 

to 1023. Like the other bio c * s ed in 

ices (tape RK disk) this f^ s consequence s: 
blocks, not bytes. Trus n not byte 

seek calls refer ^o blodc nm^e , wri always 

ters from successive blocks. 



OWNER 



found in /dev 
tapO(IV), rkO(IV) 



Th6 fact that this ^vice is addressed inarms 
of blocks, not bytes, ** /*^meiy ^ 

It is due entirely tottefMt* argume nts to 

write pointers ^<* ^equent y numbers. 
58g rea^as^to S^tS?^ unfortunately 
the repercussions are serious. 

ken , dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



RKO (IV) 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



rk0 __ rk03 (or RK05) disk 



^ refers to the entire RK03 f t f ^^flocks 

s^usssrs-^.^ c bif nt r d ? the 

tape files, its addressing is block-oriented. 
Consult the rfO(IV) section. 

found in /dev 
rfO(IV), tapO(IV) 



See rfO(IV) 
ken , dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



RPO (IV) 



FILES 
SEE ALSO 
DIAGNOSTICS 
BOGS 

OWNER 



rp — RP11/RP02 disk 



rnO refers to the entire RP02 disk as a single 
SLentiaUy-addressed file. Its 256-word blocks 
*r2 numbered to 40599. Like the RF disk and 
the SmeS.its addressing is block-oriented. 
Consult the rfO(IV) section. 

found in /dev 
rfO(IV), tapO(IV) 



See rf0(iv) 

Due to a hardware 

not be accessed. 

ken , dmr 



bug. 



block 40599 on the RP can- 



- 1 - 



3/15/72 



TAPO 



TAP7 (IV) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



tapO • . . tap? 



These files refer to DECtape drives to 7. 
Since the logical drive number can be manually 
set, all eight files exist even though at present 
there are fewer physical drives. 

The 2 56-word blocks on a standard DECtape are 
numbered to 577. However, the system makes no 
assumption about this number; a block can be read 
or written if it exists on the tape and not oth- 
erwise. An error is returned if a transaction is 
attempted for a block which does not exist. 

Like the RK and RF special files, addressing on 
the tape files is block-oriented. See the RFO 
section. 

found in /dev 

/dev/rfO, /dev/rkO 



see /dev/rfO 
ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



TTY (IV) 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



tty — console typewriter 



ttv (as distinct from ttyO, .... tt^m) refers to 
thS console typewriter hard-wired to the PDP-11. 

Generally, the disciplines involved in dealing 
with tty are similar to those for ttyO ... and 
the appropriate section should be consulted. The 
following differences are salient: 

The system calls stty and gtty do not apply to 
this device. It clHnot be placed in raw mode; on 
inout upper case letters are always mapped into 
iower' case letters; a carriage return is echoed 
when a line-feed is typed. 

The quit character is not FS (as with^^yO. . . ) „ 
but is generated by the key labelled alt mode. 

By appropriate console switch settings, it is 
possibleto cause UNIX to come up as a single 
user system with I/O on this device. 

found in /dev 
ttyO(lV), init(VIl) 



ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



TTYO (IV) 



ttyO 



tty7 — communications interfaces 



TfcPae files refer to DC11 asynchronous communica- 
tion J interfaces. At the moment there are eight 
oK but the number is subject to change. 

When one of these files is opened, it causes the 

^L«« %r» wait until a connection is esta- 
SSSS. (in practice, however, user's programs 
blisnea. \±» y f<1 .. thev are opened by .in it 

S«?r7n handling quit or interrupt signals, as 
role in hancuing qu contr ol typewriter is in- 
discussed below. The control uyy 
herited by a child process durxng a fork. 

A terminal associated with one of these f lies _ 
ordinarily operates in full-duplex mode Chirac 
ters may be typed at any time, even^ ^ ^^ 

^ ° C< Sll ±lvul buffers become completely choKed, 

this is happening the character * 
every lost input character. 

When first opened, the standard i nt «*~J_ "J?* 
W assumed r includes: ASCII ^^r.^ (~W 

delays transmission after sending new _ 

type Model 37, tne £J X * rmiN et 300. Most of 
the system call stty^-LJ.;. -^ *L am ^^able in- 

parity, odd parity, or both, a raw J" 

Sll characters may be read one *t at ime, 

riage return (CR) ^.J? * h " ?l"e fSSd (LF) 
newline on input and -ther CR ^^ ng of 

cause echoing of the sequei suppression 
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characters; the echoing of input tabs as spaces; 
and setting the system to handle IBM 2741s. See 
getty(VIl) for the way that terminal speed and 
type are detected. 

Normally, typewriter input is processed in units 
of lines. This means that a program attempting 
to read will be suspended until an entire line 
has been typed. Also, no matter how many charac- 
ters are requested in the read call, at most one 
line will be returned. It is not however neces- 
sary to read a whole line at once; any number of 
characters may be requested in a read, even one, 
without losing information. 

During input, erase and kill processing is nor- 
mally done. The character # erases the last 
character typed, except that it will not erase 
beyond the beginning of a line or an EOF. The 
character "§" kills the entire line up to the 
point where it was typed, but not beyond an EOF. 
Both these characters operate on a keystroke 
basis independently of any backspacing or tabbing 
that may have been done. Either @ or m # m may 
be entered literally by preceding it by \ j the 
erase or kill character remains, but the \ 
disappears. 

It is possible to use raw mode in which the pro- 
gram reading is wakened on each character. The 
program waits only until at least one character 
has been typed. In raw mode, no erase or kill 
processing is done; and the EOT, quit and inter- 
rupt characters are not treated specially. 

The ASCII EOT character may be used to generate 
an end of file from a typewriter. When an EOT is 
received, all the characters waiting to be read 
are immediately passed to the program, without 
waiting for a new -line. Thus if there are no 
characters waiting, which is to say the EOT oc- 
curred at the beginning of a line, zero charac- 
ters will be passed back, and this is the stan- 
dard' end-of -file signal. 

When the carrier signal from the dataset drops 
(usually because the user has hung up his termi- 
nal) any read returns with an end-of -file indica- 
tion. Thus programs which read a typewriter and 
test for end-of -file on their input can terminate 
appropriately when hung up on. 

Two characters have a special meaning when^typed. 
The ASCII DEL character (sometimes called rub- 
out") is the interrupt signal. When this charac- 
ter is received from a given typewriter, a search 
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is made for all processes which have this type- 
writer as their control typewriter, and which 
have not informed the system that they wish to 
ignore interrupts. If there is more than one 
such process, one of these is selected, for prac- 
tical purposes at random. If interrupts aren t 
being ignored, the process is either forced to 
exit or a trap is simulated to an agreed-upon 
location in the process. See intr(Il). 

The ASCII character FS is the quit signal. Its 
treatment is identical to the interrupt signal 
except that unless the receiving process has made 
other arrangements it will not only be terminated 
but a core image file will be generated. See 
quit(ll). 

Output is prosaic compared to input. When one or 
more characters are written, they are actually 
transmitted to the terminal as soon as 
previously-written characters have finished typ- 
ing. Input characters are echoed by putting them 
in the output queue as they arrive. When a pro- 
gram produces characters more rapidly than they 
can be typed, it will be suspended when its out- 
put queue exceeds some limit. When the queue has 
drained down to some threshold the program is 
resumed. Even parity is always generated on out- 
put. The EOT character is not transmitted to 
prevent terminals which respond to it from being 
hung up. 

The system will handle IBM 2741 terminals. See 
getty(VTl) for the way that 2741s are detected. 
In 2741 mode, the hardware state is: 134.5 baud; 
one output stop bit; and 7 bits/character. Be- 
cause the 2741 is inherently half-duplex, input 
is not echoed. Proper function delays are pro- 
vided. For 2741s without a feature known as 
"transmit interrupt" it is not possible to col- 
lect input ahead of the time that a program reads 
the typewriter, because once the keyboard has 
been enabled there is no way to send further out- 
put to the 2741. It is currently assumed that 
the feature is absent; thus the keyboard is un-^ 
locked only when some program reads. The inter 
rupt signal (normally ASCII DEL) is simulated 
when the 2741 "attention key is pushed to gen- 
erate either a 2741 style EOT or a break. It is 
not possible to generate anything corresponding 
to the end-of-file EOT or the quit signal. 
Currently IBM EBCDIC is default for input and 
output; correspondence code output is settabie 
(see stty(l)). The full ASCII character set is 
not available: [ , ] , { . ) » » are .™;" 
ing on input and are printed as blank on output; 
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FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



*" is used for "\"; "-*" for 



TTYO (IV) 



"»" for both 



' and"' "on' output-, and "'" maps into on 
inpu?. Similar mappings occur with correspon- 
dence code output. 

found in /dev 
tty(l), getty(VIl) 



The primarily Model 37 oriented delays may not be 
appropriate for all other ASCII terminals. 



OWNER 



ken, dmr, jfo 
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A. OUT (V) 



NAME 

SYNOPSIS 

DESCRIPTION 



a . out « — 



assembler and link editof output 



a .out is the output file of the assembler as and 
the link editor Id. In both -case's, a .out is exe- 
cutable provided there were no errors and no 
unresolved external references. / 

This file has four sections: a header, the pro- 
gram and data text, a symbol table, and reloca- 
tion bits (in that order). The last two may tf be 
empty if the program was loaded with the -s 
option of Id or if the symbols and relocation 
have been removed by strip ./ 

The header always contains 8 words: 

1 a H br .+2CT instruction (407(8)) 

2 The size of the program text segment 

3 The size of the initialized data segment 

4 The size of the uninitialized (bss) segment 

5 The size of the symbol table 

6 The entry location (always at present) 

7 The stack size required (0 at present) 

8 A flag indicating relocation bits have been 
suppressed 

The sizes of each segment are in bytes but are 
even. The size of the header is not included in 
any of the other sizes. 

When a file produced by the assembler or loader 
is loaded into core for execution, three logical 
segments are set up: the text segment, the data 
segment, and the uninitialized segment, in that 
order. The text segment begins at the lowest 
location in the core image; the header is not 
loaded. The data segment begins immediately 
after the text segment, and the bss segment im- 
mediately after the data segment. The bss seg- 
ment is initialized by 0's. In the future the 
text segment will be write-protected and shared. 

The start of the text segment in the file is 
20(8); the start of the data segment is 20+S t 
(the size of the text) the start of the reloca- 
tion information is 20+S +S ; the start of the 
symbol table is 20+2(S +5 ) u if the relocation 



information is present^ 20+S t +S d 



ifr 



if not. 



The symbol table consists of 6-word entries. The 
first four contain the ASCII name of the symbol, 
null-padded. The next word is a flag indicating 
the type of symbol. The following values are 
possible: 
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00 undefined symbol 

01 absolute symbol 

02 text segment symbol 

03 data segment symbol 

04 bss segment symbol 

40 undefined external (.globl) symbol 

41 absolute external symbol 

42 text segment external symbol 

43 data segment external symbol 

44 bss segment external symbol 

Values other than those given above may occur if 
the user has defined some of his own instruc- 
tions. 

The last word of a symbol table entry contains 
the value of the symbol. 

If the symbol's type is undefined external, and 
the value field is non-zero, the symbol is inter 
preted by the loader Id as the name of a common 
region whose size is indicated by the value of 
the symbol. 

If a . out contains no unresolved global refer- 
enceFTthe text portions are exactly as they will 
appear in core when the file is executed. If the 
value of a word in the text portion involves a 
reference to an undefined global, the word is 
replaced by the offset to be added to the 
symbol's value when it becomes defined. 

If relocation information is present, it amounts 
to one word per word of program text or initial- 
ized data. There is no relocation information if 
the "suppress relocation flag in the header is 
on. 

Bits 3-1 of a relocation word indicate the seg- 
ment referred to by the text or data word associ- 
ated with the relocation word: 

00 indicates the reference is absolute 
02 indicates the reference is to the text seg- 
ment «.-„_ 
04 indicates the reference is to the data seg 

ment „ Q „ 

06 indicates the reference is to the bss seg- 

10 indicates the reference is to an undefined 
external symbol. 

Bit of the relocation word indicates if on that 
the reference is relative to the pc (e.g. clr 
x"); if off* the reference is to the actual sym- 
bol' (e.g., clr *sx M ). 
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The remainder of the relocation word (bits 15-4) 
ontaSa symbol number in the case o external 
references, and is unused otherwise. The first 
symbol is numbered 0, the second 1, etc. 



FILES — 

SEE ALSO as Id, strip, nm, un(l) 

DIAGNOSTICS 

BUGS 

OWNER dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



archive (library) file format 



The archive command ar is used to combine several 
files into one. Its use has three benefits: when 
files are combined, the file space consumed by 
the breakage at the end of each file (256 bytes 
on the average) is saved; directories are smaller 
and less confusing; archive files of object pro- 
grams may be searched as libraries by the loader 

Id. 

A file produced by ar has a "magic number" at the 
start, followed by the constituent files, each 
preceded by a file header. The magic number is 
-147(10), or 177555(8) (it was chosen to be un- 
likely to occur anywhere else). The header of 
each file is 16 bytes long: 



0-7 



file name, null padded on the right 



8-11 



Modification time of the file 



12 



13 



User ID of file owner 



file mode 



14-15 

file size 

If the file is an odd number of bytes long, it is 
padded with a null byte, but the size in the 
header is correct. 

Notice there is no provision for empty areas in 
an archive file. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



ar , Id 



ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



format of core image 



Three conditions cause UNIX to write out the core 
image of an executing program: the program gen- 
erates an unexpected trap (by a bus error „ 
illegal instruction); the user send a quit 
sional (which has not been turned off by the 
program ; a trap is simulated by ^e floating 
point simulator. The core image is called core 
and is written in the current ^^ ""f °£ 
(provided it can be; normal access controls ap 

ply). 

The size and structure of the core image file 
depend to some extent on which syst ^ is in- 
volved. in general there is a 512-byte area at 
the end which contains the system s P^-P™®" 
Sata for that process. The remainder represents 
S act al contents of the user's core area when 

P ^sTrea ^Si.S^n^%rt£5 t on5- 
the^a?ions from user to the program break, 
plus the stack, is dumped. 

When any trap which is not an i/O in t err Jf* °J" 
curs, all the useful registers are stored on the 
stack. After all the registers have £een -tored , 
the contents of sp are placed in the first ceil 
of the user area; this cell is called u^. 
?Lrefore within the core image proper, there is 
an aref which contains the following registers in 
?he following order (increasing addresses): 

(u.sp)->sc 
mq 
ac 
r5 
r4 
r3 
r2 
r1 

pc (at time of fault) 

processor status (at time of fault) 

The last two are stored by th e hardw are It fol- 
lows that the contents of so at the time o 
fault were (u.sp) plus 22(10). 
The actual location of this data depends onjhich 
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there is only one stack, and it is located in the 
user's core area. 

In general the debugger db(l) should be used to 
deal with core images. 

FILES 

SEE ALSO — 

DIAGNOSTICS 

BUGS 

OWNER ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



format of directories 



A directory behaves exactly like an ordinary 
file, save that no user may write into a directo- 
ry. The fact that a file is a directory is indi- 
cated by a bit in the flag word of its i-node 
entry. 

Directory entries are 10 bytes long. The first 
word is the i-node of the file represented by the 
entry, if non-zero; if zero, the entry is empty. 

Bytes 2-9 represent the (8-character) file name, 
null padded on the right. These bytes are not 
necessarily cleared for empty slots. 

Bv convention, the first two entries in each 
directory are for ". and ... The first is an 
entry for the directory itself. The second is 
for the parent directory. The meaning of .. is 
modified" for the root directory of the master 
file system and for the root directories of re- 
movable file systems. In the first case, there 
is no parent, and in the second, the system does 
not permit off-device references without a mount 
system call. Therefore in both cases .. has 
the same meaning as . • 



file system format 



ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



format of file system 



Every file system storage volume (e.g. RF disk, 
RK disk, DECtape reel) has a common format for 
certain vital information. 

Every such volume is divided into a certain 
number of 256 word (512 byte) blocks. Blocks 
Snd 1 are collectively known as the super-block 
for the device; they define its extent and con- 
tain an i-node map and a free-storage map. The 
first word contains the number of bytes in the 
free-storage map; it is always even It is fol- 
lowed by the map. There is one bit for each 
block on the device; the bit is ' "J*f^£ 1b 
is free. Thus if the number of free-map bytes is 
n the blocks on the device are numbered 
Tbrough 8n!l ! The free-map count is followed by 
the f?ee map* itself. The bit for block £ o the 
device is in byte k/8 of the map; it is offset 
kTmod 8) bits from the right. Notice that bits 
ixist for the superblock and the i-list even 
though they are never allocated or freed. 

After the free map is a word containing the byte 
count for the i-node map. It too is alwy even, 
^numbers below 41(10) are reserved for special 
fiJes, and are never allocated; the first bit in 
the i-node free map refers to i-number 41. 
Therefore the byte" number in the i-n°J e »»*,*£ 
i-node i is (1-4D/8. It is of fs et (i-41 ) (mod 
8) bits"from the right; unlike the free map, a 
**o" bit indicates an available i-node. 

I_numbers begin at 1 , and the storage for Ixodes 
begins at block 2. Also, i-nodes are 32 bytes 
lona so 16 of them fit into a block. Therefore, 
i!node 1 is located in block (i+31 1/16 of the 
file syitem, and begins 32' ( ( i+31 ) (mod 16)) bytes 
from its start. 

There is always one file system ^ ich ^ s .^ W ^ S 
mounted; in standard UNIX it resides on the RF 
d?sk This device is also used for swapping. 
&f swap areas are at the high addresses on the 
oevice. It would be convenient if these ad- 

Lfmap! fre^t-Lfed^rervet %*£>£ 
wltnin any file. These are the blocks that show 
up "missing" in a check of the RF disk. 

Again on the primary file system device, there 
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are several pieces of information following that 
previously discussed. They contain basically the 
information typed by the tm command; namely, the 
times spent since a cold boot in various ca- 
tegories, and a count of I/O errors. In particu- 
lar, there are two words with the calendar time 
(measured since 00:00 Jan 1 f 1971); two words 
with the time spent executing in the system; two 
words with the time spent waiting for I/O on the 
RF and RK disks; two words with the time spent 
executing in a user's core; one byte with the 
count of errors on the RF disk; and one byte with 
the count of errors on the RK disk. All the 
times are measured in sixtieths of a second. 

I-node 41(10) is reserved for the root directory 
of the file system. No i-numbers other than this 
one and those from 1 to 40 (which represent spe- 
cial files) have a built-in meaning. Each i-node 
represents one file. The format of an i-node is 
as follows, where the left column represents the 
offset from the beginning of the i-node; 

0-1 flags (see below) 

2 number of links 

3 user ID of owner 
4-5 size in bytes 

6-7 first indirect block or contents block 

20^21 eighth indirect block or contents block 

22-25 creation time 

26-29 modification time 
30-31 unused 

The flags are as follows: 

100000 i-node is allocated 

040000 directory 

020000 file has been modified (always on) 

010000 large file 

000040 set user ID on execution 

000020 executable 

000010 read, owner 

000004 write, owner 
000002 read, non-owner 
000001 write, non-owner 

The allocated bit (flag 100000) is believed even 
if the i-node map says the i-node is free; thus 
corruption of the map may cause i-nodes to become 
unallocatable, but will not cause active nodes to 
be reused. 

Byte number n of a file is accessed as follows: n 
is divided by 512 to find its logical block 
number (say b) in the file. If the file is small 
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FILE SYSTEM (v) 



OWNER 



(flag 010000 is 0), then b must be less than 8, 
and the physical block number corresponding to b 
is the bth entry in the address portion of the 
i-node. 

If the file is large, b is divided by 256 to 
yield a number which must be less than 8 (or the 
file is too large for UNIX to handle). The 
corresDonding slot in the i-node address portion 
gives the physical block number of an indirect 
block. The residue mod 256 of b is multiplied by 
two (to give a byte offset in the indirect block) 
and the word found there is the physical address 
of the block corresponding to b. 

If block b in a file exists, it is not necessary 
that all blocks less than b exist. A zero block 
number either in the address words of the i-node 
or in an indirect block indicates that the 
corresponding block has never been allocated. 
Such a missing block reads as if it contained all 
zero words. 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



format of directories 



Two blocks are not enough to handle the i- and 
free-storage maps for an RP02 disk pack, which 
contains around 10 million words. 
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NAME 

SYNOPSIS 

DESCRIPTION 



IDENT (V) 



ident — IDENT card file 



ident is a file used to generate GECOS SIDENT 
cards by the off-line print program opr(l). 
There is one entry per line in the following 
style: 

05:m1 234, m789, name 

which causes the following SIDENT card to be 
generated: 

s IDENT it\1234,m789,name 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



kept in /etc/ident. 
opr(l) 



ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



PASSWD (V) 



passwd — password file 



passwd contains for each user the following 
information: 

name (login name) 
password 

numerical user ID 
default working directory 
program to use as Shell 

This is an ASCII file. Each field within each 
user's entry is separated from the next by a 
colon. Each user is separated from the next by a 
new-line. If the password f ield is null, no 
password is demanded; if the Shell field is null, 
the Shell itself is used. 

This file, naturally, is inaccessible to anyone 
but the super-user. 

This file resides in directory /etc. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



/etc/init 



super-user 
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TAP (V) 



NAME 

SYNOPSIS 

DESCRIPTION 



tap — DEC/mag tape formats 



The DECtape command tap and the magtape command 
mt dump and extract files to and from their 
Respective tape media. The format of these tapes 
are the same. 

Block zero of the tape is not used. It is avail- 
able as a boot program to be used in a stand 
alone enviornment. This has proved valuable for 
DEC diagnostic programs. 

Blocks 1 thru 24 contain a directory of the tape. 
There are 192 entries in the directory; 8 entries 
per block; 64 bytes per entry. Each entry has 
the following format: 



path name 


32 bytes 


mode 


1 byte 


uid 


1 byte 


size 


2 bytes 


time modified 


4 bytes 


tape address 


2 bytes 


unused 


20 bytes 


check sum 


2 bytes 



The path name entry is the path name of the file 
when put on the tape. If the pathname starts 
with a zero word, the entry is empty. It is at 
most 32 bytes long and ends in a null byte. 
Mode, uid, size and time modified are the same as 
described under inodes (see file system (V)) The 
tape address is the tape block number of the_ 
start of the contents of the file. Every file 
starts on a block boundary. The file occupies 
(size+51l)/512 blocks of continuous tape. The 
checksum entry has a value such that the sum of 
the 32 words of the directory is zero. 

Blocks 25 on are available for file storage. 

A fake entry (see mt(l), tap(D) has a size of 
zero. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



filesystem(v), mt(l), tap(l) 



ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



UIDS (V) 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



/etc/uids — map user names to user IDs 



This file allows programs to map user names into 
user numbers and vice versa. Anyone can read it. 
It resides in directory /etc, and should be up- 
dated along with the password file when a user is 
added or deleted. 

The format is an ASCII name, followed by a colon, 
followed by a decimal ASCII user ID number. 



dmr, ken 
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UTMP (V) 



NAME 

SYNOPSIS 

DESCRIPTION 



/tmp/utmp 



user information 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 



This file allows one to discover information 
about who is currently using UNIX. The file is 
binary; each entry is 16(10) bytes long. The 
first eight bytes contain a user s login name or 
are null if the table slot is unused. The low 
order byte of the next word contains the last^ 
character of a typewriter name (currently, to 
'5' for /dev/ttyO to /dev/tty5). The next two 
words contain the user's login time. The last 
word is unused. 

This file resides in directory /tmp. 



/etc/init, which maintains the file. 



ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



WTMP (V) 



/tmp/wtmp — user login history 



This file records all logins and logouts. Its 
format is exactly like utmp(v) except that a null 
user name indicates a logout on the ^f ^^.^ 
typewriter, and the typewriter name x indicates 
that UNIX was rebooted at that point. 

Wtmp is maintained by login(l) and init(VIl) . 
Neither of these programs creates the filj» so XI 
it is removed record-keeping is turned off. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



init(VIl), login(l), tacct(l), acct(l) 



ken , dmr 
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BASIC (VI) 



NAME 

SYNOPSIS 

DESCRIPTION 



basic — ■ DEC supplied BASIC 
basic [file] 

Basic is the standard BASIC V000 distributed as a 
stand alone program. The optional file argument 
is read before the console. See DEC-1 1 -AJPB-D 
manual. 

Since bas is smaller and faster, basic is not 
maintained on line. 



FILES 


"'™ 


SEE ALSO 


bas 


DIAGNOSTICS 


See manual 


BUGS 


GOK 


OWNER 


dmr 
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BC (VI) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 



SEE ALSO 

DIAGNOSTICS 
BUGS 

OWNER 



be — B interpreter 
be [ ^c ] sf ile 1 jb . . 



ofile 



1 



be is the UNIX B interpreter. It accepts three 
types of arguments: 

Arguments whose names end with ".b" are assumed 
to be B source programs; they are compiled, and 
the object program is left on the file sfile^o 
(i.e. the file whose name^is^that of the source 
with ".o" substituted for ".b ). 

Other arguments (except for "-c") are assumed to 
be either loader flag arguments, or B-compatible 
object programs, typically produced by an earlier 
be run, or perhaps libraries of B-compatible 
routines. These programs, together with the 
results of any compilations specified, are loaded 
(in the order given) to produce an executable 
program with name a. out . 

The "-c" argument suppresses the loading phase, 
as does any syntax error in any of the routines 
being compiled. 

The language itself is described in [1] . 

The future if B is uncertain. The language has 
been totally eclipsed by the newer, more power- 
ful, more compact, and faster language C. 



file.b 

a. out 

b.tmpl 

b.tmp2 

/usr/lang/bdir/b[ca] 

/usr/lang/bdir/brt [1 2] 

/usr/lib/libb.a 

/usr/lang/bdir/bilib. a 



input file 
loaded output 
temporary (deleted) 
temporary (deleted) 
translator 

runtime initialization 
builtin functions, etc. 
interpreter library 



[1] K. 
to B. 
C(I) 



Thompson; MM-72-1 271-1 ; Users' Reference 



see 



[1]. 



Certain external initializations are illegal. 
(In particular: strings and addresses of exter 
nals. ) 

ken , dmr 
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BJ (VI) 



NAME 

SYNOPSIS 

DESCRIPTION 



b< j — the game of black jack 
/usr/games/bj 

Black jack is a serious attempt at simulating the 
dealer in the game of black jack (or twenty-one) 
as might be found in Reno. 

The following rules apply: 

The bet is $2 every hand. 

A player 'natural' (black jack) pays $3. A 
dealer natural loses $2. Both dealer and 
player naturals is a 'push (no money ex- 
change ) • 

If the dealer has an ace up, the player is 
allowed to make an 'insurance bet aga inst the 
chance of a dealer natural. If this bet is 
not taken, play resumes as normal. It the oex. 
Is taken, it is a side bet where the player 
wins s2 if the dealer has a natural and loses 
$1 if the dealer does not. 

If the player is dealt two cards of th e same 
value, he is allowed to 'double . He is al 
lowed to play two hands, each with one of 
these cards. (The bet is doubled also; $2 on 
each hand. ) 

If a dealt hand has a total # of ten or eleven, 
the player may 'double down'. He may double 
the bet ($2 to $4) and receive exactly one 
more card on that hand. 

Under normal play, the player may 'hit' (draw 
a card) as long as his total is not over 
?wentylone. If the player 'busts' (goes over 
twenty-one), the dealer wins the bet. 

When the player 'stands' (J ecide % n °^° J£° ' 
the dealer hits until he attains a total of 
seventeen or more. If the dealer busts, the 
player wins the bet. 

If both player and dealer stand the one with 
the largest total wins. A tie is a push. 

The machine deals and keeps ^ore. The following 
questions will be asked at appropriate times. 
?ach question is answered by v followed by a new 
line for 'yes', or just new line for no . 

? means 'do you want a hit? 
Insureance? 
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Double down? 

Every time the deck is shuffled, the dealer so 
states and the 'action' (total bet) and stand- 
ina' (total won or loss) is printed. To exit, 
hi? the interrupt key (DEL) and the action and 
standing will be printed. 

FILES — 

SEE ALSO 

DIAGNOSTICS 

BUGS — 

OWNER ken 
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CAL (VI) 



NAME 

SYNOPSIS 

DESCRIPTION 



cal — print calendar 
/usr/ken/cal year 

Cal will print a calendar for the given year. 
The year can be between (really 1 BC) and 9999. 
For years when several calendars were in vogue in 
different countries, the calendar of England (and 
therefore her colonies) is printed. 

P.S. try cal of 1752. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 



CHASH (VI) 

chash — precompile a hash table for cref 
chash filel file2 

CHASH takes symbols (character sequences; one per 
line) from filel and compiles a hash table for 
the use of cref . The table is written on file2. 

A subroutine suitable for searching such a hash 
table is available from the author. 



cref 



There can only be 199 symbols; they may total 
only 600 characters of text. 

lem 
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NAME 

SYNOPSIS 

DESCRIPTION 



CREF (VI) 



FILES 



SEE ALSO 
DIAGNOSTICS 



cref 



make cross reference listing 



cref [ -soi ] namel . . . 

crff makes a cross reference listing of files in 
assembler format (see AS(D). The «!•■ »™£ 
arguments in the command line are J^^L^L 
symbols (defined as a succession of alphabetics, 
numerics, '.', or/.', beginning with an alpha- 
betic, '.', or '_')• 
The output report is in four columns: 

text as it appears in tile 



(1) 


(2) 


(3) 


symbol 


file 


see 
below 



The third column contains the line number in the 
f^e by default; the ^ option will cause the 
most recent name symbol to appear there instead. 

CREF uses either an ignor e file or £ §Si* e f £^ 
Tt = +Y>e> -i oDtion is given, it will take tne ri«^ 
f!le nami tl be an ignore' file; if the =o option 

I „£ln the next "file name will be taken as an 
^Tile.^Eithfr ignore or only, file. J must be 
SS&L by chash (q.v.TT If an ignore file is 
«?*ro« a ll th e symbols in the file will be ig- 
nored'in'column^O and (3) of the output. If 

^i,r fMi<* is aiven. only symbols appearing in 
*lge 1 p2i» oolwT(l). but column 
U) will "till contain the most recent nan-e en- 
countered. Only one of the "P"^.^ =^ 
v p u «?ed The default setting is = i; all symDoxs 
P^edelined in the assembler are ignored, except 

system call names, which are collected. 

«--i 4-n4-i t- 7 t.3 are created (i.e. 

DES?ROY^D) in the^rfcing directory of anyone 

u«?nc cref ?his nuisance will be repaired soon. 

The oufiSt'is left in file s^oyt in the »rKm, 

directory. 

/usr/lem/s.tab is the default ignore file. 

chash(Vl); as (I) 

"line too long" - input line >131 characters 
"symbol too long" — symbol >20 characters 
"too many symbols" - >10 symbols in line 
"cannot open t.?" — hug; see author 
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BUGS 



CREF (VI) 

"cannot fork; examine t.out" --can't start sojM: 
process; intermediate results are on files 
t.O, 1. 1,^,^3. These may be sorted in- 
dependently and the results concatenated by 
the user. 

"cannot sort" — odd response from sort; examine 
intermediate results, as above. 

"impossible situation" — system bug 

"cannot open" file -- one of the input names 
cannot be opened for reading. 

The destruction of unsuspecting users' files 
should soon be fixed. A limitation that may 
eventually go away is the restriction to assem- 
bler language format. There should be options for 
FORTRAN, English, etc., lexical analysis. 

File names longer than eight characters cause 
misalignment in the output if tabs are set at 
every eigth column. 



OWNER l em 
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NAME 



SYNOPSIS 



das — disassembler 



DESCRIPTION A PDP-11 disassembler exists. Contact the owner 

for more information. 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER ken 
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NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



DLI (VI) 

dli — load DEC "binary paper tapes 
dli output [input] 

dli will load a DEC binary paper tape into the 
output file. The binary format paper tape is 
read from the input file (/dev/ppt is default.) 

/dev/ppt 



checksum 



drnr 
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NAME 

SYNOPSIS 

DESCRIPTION 



DPT (VI) 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 



apt 



reaa DEC ASCII paper tape 



apt output [input] 

d£t reaas the input file (/dev/ppt default )as- 
dma the format is a DEC generated ASCII pape 



suming the 

tape of an assembly language program. 

is a UNIX ASCII assembly program. 

/dev/ppt 



paper 
The output 



Almost always a hand pass is required to get a 
correct output. 

ken , amr 
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MOO (VI) 



NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



moo — a game 

/usr/games/moo 

moo is a guessing game imported from England. 



ken 



- 1 - 



3/1 5/72 



PTX (VI) 



NAME 
SYNOPSIS 

DESCRIPTION 



ptx 



permuted index 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



ptxl input tempi 
sort tempi temp2 
ptx 2 temp2 output 

ptx generates a permuted index from file input on 
file output . It is in two pieces: the first does 
the permutation, generating one line for each 
keyword in an input line* The keyword is rotated 
to the front. The permuted file must then be 
sorted. ptx2 then rotates each line around the 
middle of the page. 



input should be edited to remove useless lines. 
The following words are suppressed: a f and ^ 
-as", "is-, *for", "of , on", "or., the , to , 
up • 

The index for this manual was generated using 
Ptx . 



sort 



dmr 
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TMG (VI) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 
DIAGNOSTICS 



tmg — compiler compiler 
tmg name 

tmg produces a translator for the language whose 
syntactic and translation rules are described in 
file name.t. The new translator appears in a. out 
and may be used thus: 

a .out input [ output ] 

Except in rare cases input must be a randomly 
addressable file. If no output file is speci- 
fied, the standard output file is assumed. 

The tmg language is described in (Reference). 

/etc/tmg — the compiler-compiler 
/etc/tmga, /etc/tmgb,/etc/tmgc — libraries 
/etc/tmgO.s — global definitions 



??? — illegal input, offending line follows 

fatal error codes, appear in tmg and a. out: 

a( j — address out of bounds 

so — stack overflow 

ga — address out of bounds while generating 

}co — too much parse without output 

to — symbol table overflow 

gn — getnam on symbol not in table 

co — character string overflow 



BUGS 
OWNER 



doug 
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NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



TTT (VI) 



ttt — tic-tac-toe 
/usr/games/ttt 

ttt is the X's and o's game popular in 1st grade. 
This is a learning program that never makes the 
same mistake twice. 



ttt.k — old mistakes 



ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



ASCII (VII) 



000 
010 
020 
030 
040 
050 
060 
070 
I 100 
110 
120 
130 
140 
150 
160 
170 



mil j 001 
bs 1011 
dlej021 
can! 031 
sp |041 



( 

8 

9 
H 
P 
X 

h 

P 
x 



J051 
{061 
',071 
1101 
1111 

i 121 

1131 
j 141 

J151 
1161 
J171 



ascii — map of ASCII character set 
cat /usr/pub/ascii 



ascii 
print 



is a map of the ASCII character set, to be 
ed as needed. It contains: 



soh 
ht 
dd 
em 
I 

) 
1 

9 
A 

I 
Q 
Y 
a 

i 

q 
y 



002 

012 

022 

032 

042 

052 

062 

072 

102 

112 

122 

132 

142 

152 

162 

172 



stx 
nl 
dc2 
sub 

* 
2 

• 

B 
J 
R 
Z 
b 

j 

r 
z 



003 

013 

023 

033 

043 

053 

063 

073 

103 

113 

123 

133 

143 

153 

163 

173 



etx 
vt 
dc3 
esc 

# 

+ 

3 

> 

C 

K 

S 

[ 

C 

k 

s 

{ 



004 

014 

024 

034 

044 

054 

064 

074 

104 

114 

124 

134 

144 

154 

164 

174 



eot 
np 
dc4 
fs 
$ 

t 

4 

< 

D 
L 
T 

\ 

d 
1 
t 



005 

015 

025 

035 

045 

055 

065 

075 

105 

115 

125 

135 

145 

155 

165 

175 



enq 
cr 
nak 
gs 
% 



E 
M 
U 

] 
e 
m 
u 

> 



006 

016 

026 

036 

046 

056 

066 

076 

106 

116 

126 

136 

146 

156 

166 

176 



ack 

so 

syn 

rs 
& 

• 

6 
> 

F 
N 
V 

f 
n 
v 



007 

017 

027 

037 

047 

057 

067 

077 

107 

117 

127 

137 

147 

157 

167 

177 



bel 
si 
etb 
us 

/ 

7 
? 

G 

W 

g 

o 

w 

del 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



found in /usr/pub 



jfo 
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BOOT PROCEDURES (VII) 



NAME 



bos, maki, rom, vcboot, msys, et al 



SYNOPSIS 
DESCRIPTION 



On the RF disk, the highest 16K words are 
reserved for stand-alone programs. These 
words are allocated as follows: 



16K 



bos 

Warm UNIX 

Cold UNIX 



173000: 



(1K) 
(7K) 
(8K) 



The UNIX read only memory (ROM) is home cut with 
2 programs of 16 words each. The first (address 
173000) reads bos from the RF disk into core 
location 154000 and transfers to 154000. The 
other ROM program (address 173040) reads a 
DECtape sitting in the end-zone on drive into 
core location and transfers to 0. This latter 
operation is compatible with part of DEC f stan- 
dard ROM. The disassembled code for the UNIX ROM 
f ol lows : 



173040: 



mov 

mov 

mov 

mov 

mov 

mov 

tstb 

bge 

jmp 

mov 

clr 

mov 

mov 

tstb 

bge 

tst 

bne 

movb 

tstb 

bge 

clr 



$1 77472, r0 

$3,-(r0) 

$1 40000, -(r0) 

$1 54000, -(rO) 

$-2000, -(r0) 

$5,-(r0) 

(r0) 

.-2 

*$ 154000 

$1 77350, r0 

-(r0) 

r0,-(r0) 

$3,-(r0) 

(r0) 

.-2 

*$177350 

$5,(r0) 
(r0) 
.-2 
pc 



12700; 177472 

12740; 3 

12 740; 140000 

12740; 154000 

12740 ; 176000 

12740; 5 

105710 

2376 

137; 154000 

12700; 177350 

5040 

10040 

12740;3 

105710 

2 376 

5737;177350 

1377 

11 2710; 5 

105710 

2376 

5007 



The program bos (Bootstrap Operating System) 
examines the~console switchs and executes one of 
several internal programs depending on the set- 
ting. The following settings are currently 
recognized: 

??? Will read Warm UNIX from the RF into core 

location and transfer to 600. 

1 Will read Cold UNIX from the RF into core 
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40 



BOOT PROCEDURES (VII) 

location and transfer to 600. 

Will dump all of memory from core loca- 
tion onto DECtape drive 7 and then 
halt. 

Will read 256 words from RK0 into core 
and transfer to zero. This is the pro- 
cedure to boot DOS from an RK. 

This is the same as 10 above, but instead 
of halting, UNIX warm is loaded. 

o Will load a standard UNIX binary paper 

tape into core location and transfer to 
0. 

77500 Will load the standard DEC absolute and 
binary loaders and transfer to 77500. 

Thus we come to the UNIX warm boot P r ^edure: put 

73000 into the switches, push load address and 
then push start . The alternate switch setting of 
173030 thaT^ill load warm UNIX is used as a sig- 
nal to bring up a single user system for special 
purposes. See init(VIl). For systems without a 
?om UNIX (both warm and cold) have a copy of the 
d!sk bo£ program at location 602 This i J Prob- 
ably a better warm boot procedure because the 
program at 602 also attempts to complete out- 
standing I/O. 

Cold boots can be accomplished with the Cole 1 UNIX 
program, but they're not. Thus the Cold UNIX 
slot on the RF may have any program desirecL 
This slot is, however, used during a cold boot. 
Mount the UNIX INIT DECtape on drive positioned 
in the end-zone. Put 173040 into the switches. 
Push load address / Put 1 into the pitches 
Push itart . This reads a program called vcb^ 
from ^hTtape into core location and transfers 
to it. vcboot then reads 16K words from the 
DECtape TblScks 1-32) and copies the data to the 
niabest 16K words of the RF. Thus this initial- 
izes Se read-only part of the RF. vcboot then 

ealsin Jo. and executes it. bo^ then reads in 
Cold UNDflnd executes that Cold UNIX halts for 
a last chance before it completely ^J 1 ** 1 "" 
the RF file system. Push continue, and Cold UNIX 
Will initialize the RF. It then sets nto execu- 
tion a user program that reads the DECtape tor 
initialization files starting from block 33. 
When this is done, the program executes /etc/init 
which should have been on the tape. 

The INIT tape is made by the program maki running 
- 2 - 
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FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 



under UNIX, maki writes vcboot on block of 
/dev / tap7 . It then copies the RF 16K words 
(using /dev/rfO) onto blocks 1 thru 32. It has 
internally a list of files to be copied from 
block 33 on. This list follows: 

/etc/init 

/bin/chmod 

/bin/date 

/bin/login 

/bin/Is 

/bin/mkdir 

/etc/mount 

/bin/sh 

/bin/tap 

Thus this is the set of programs available after 
a cold boot. init and sh are mandatory. For 
multi-user UNIX, aetty and login are also neces- 
sary, mkdir is necessary due to a bug in tap., 
tap and mount are useful to bring in new files. 
As soon as possible, date should be done, 
leaves Is and chrood as frosting. 



That 



The last link in this incestuous daisy chain is 
the program msys . 

msys char file 

will copy the file file onto the RF read only 
slot specified by the characacter char. Char is 
taken from the following set: 

b bos 

u warm UNIX 

± Cold UNIX 

Due to their rarity of use, maki and msys are 
maintained off line and must be reassembled be- 
fore used. 

/dev/rfO, /dev/tap? 

init(VIl), tap(l), sh(l), mkdir(l) 



This section is very configuration dependent. 
Thus, it does not describe the boot procedure for 
any one machine. 

ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



getty — set typewriter mode and get user's n 



ame 



qettv is invoked by tnit (VII ) immediately after 
a typewriter is opened following a dial-in. The 
user's login name is read and the login(I) com- 
mand is called with this name as an argument. 
While reading this name getty attempts to adapt 
the system to the speed and type of terminal 
being used. 

qettv initially sets the speed of the interface 
to~150 baud, specifies that raw mode is to be 
used (break on every character), that echo is to 
be suppressed, and either parity allowed. It 
types the "login:" message (which includes the 
characters which put the 37 Teletype terminal 
into full-duplex and unlock its keyboard ). Then 
the user's name is read, a character at a time. 
If a null character is received, it is assumed to 
be the result of the user pushing the break 
("interrupt") key. The speed is then changed to 
300 baud and the "login: is typed again, this 
time with the appropriate sequence which puts a 
GE lermiNet 300" into full-duplex. This sequence 
is acceptable to other 300 baud terminals also. 
If a subsequent null character is received, the 
speed is changed again. The general approach is 
to cycle through a set of speeds in response to 
null characters caused by breaks. ™* ^ence 
at this installation is 150, 300, and 134.5 baud. 

Detection of IBM 2741s is accomplished while the 
speed is set to 150 baud. The user sends a 2741 
slyle "eot" character by pushing the attention 
key or by typing return; at wl 50 baud this char- 
acter looks like the ascii {M4 Q ). Upon 
receipt of the "eot 4 the system is set to 
operate 2741s and a *login: message is typed. 

The user's name is terminated by a new-line or 
carriaqe-return character. The latter results in 
the^tei being set to to treat carriage returns 
appropriately (see stty(II)). 

The user's name is scanned to see if it c °^ains 
any lower-case alphabetic characters; if not, the 
system is told to map any future upper-ca e char 
acters into the corresponding lower " cas ^^5^ 
ters. Thus UNIX is usable from upper-case-only 

terminals. 

Finally, login is called with the user's name as 
argument. 
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FILES /etc/getty 

SEE ALSO init(VIl), login(l), stty(ll) 

DIAGNOSTICS 

BUGS 

OWNER dmr, ken, jfo 
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GLOB (VII) 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



glob — generate command arguments 



OWNER 



glob is used to expand arguments to the shell 
obtaining "*",'[', or '? . It is passed the 
argument list containing the metacharacters ; glob 
expands the list and calls the command itself. 

found in /etc/glob 

sh(l) 

"No match", "No command", "no directory" 

If anv of '*', '[', or '?' occurs both quoted and 
unquoted in the original command line, even the 
quoted metacharacters are expanded. 

glob gives the "No match" diagnostic only if no 
alFiumlnts at all result. This is never the case 
if there is any argument without a metacharacter. 

dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



in 



it — process control initialization 



FILES 



SEE ALSO 



init is invoked inside UNIX as the last step in 
the~boot procedure. Generally its role is to 
create a process for each typewriter on which a 
user may log in. 

First, init checks to see if the console switches 
contain~T73030. (This number is likely to vary 
between systems.) If so, the console typewriter 
tty is opened for reading and writing and the 
ihell is invoked immediately. This feature is 
used to bring up a test system, or one which does 
not contain DC-1 1 communications interfaces. 
When the system is brought up in this way, the 
cretty and login routines mentioned below and 
described elsewhere are not needed. 

Otherwise, init does some housekeeping: the mode 
of each DECtape file is changed to 17 (in case 
the system crashed during a tap. command); airec 
tory /usr is mounted on the RKO disk; directory 
/sys is mounted on the RK1 disk. Also a J at f"- 
phone daemon is spawned to restart any jobs being 
sent. 

Then init forks several times to create a process 
for each typewriter mentioned in an internal 
table. Each of these processes opens the ap- 
propriate typewriter for reading and writing. 
These channels thus receive file descriptors 
and 1, the standard input and output. Opening 
the typewriter will usually involve a delay, 
since ?he open is not completed until someone is 
dialled in-tfed carrier established) on the chan- 
nel. Then the process executes the program ^ 
/etc/getty (q.v.). Setty will read the user s 
na^i andinvoke logih TgTv. ) to log in the user 
and execute the shell. 

Ultimately the shell will terminate because of an 
end-of-f ile either typed explicitly or generated 
as a result of hanging up. The main path of 
init, which has been waiting for such an event, 
wtkis up and removes the appropriate entry from 
the file utrnp, which records current users, and 
makes an int?y in wtmp., which maintains a history 
of logins and logouts. Then the appropriate 
typewriter is reopened and getty reinvoked. 

kept in /etc/init; uses /dev/tap, /dev/tty, 
/dev/tty?, /tmp/utmp, /tmp/wtmp 

login(l), login(VIl), getty(VIl), sh(l), dpd(l) 
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DIAGNOSTICS none possible 
BUGS none possible 

OWNER ken, dmr 
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SYNOPSIS 

DESCRIPTION 



KBD (VII) 

k - bd — keyboard map 
cat /usr/pub/kbd 

kbd contains a map to the keyboard J * mc^el 37 
Teletype terminals with the fended c^acter 
set f eature. If kbd is printed on such a term! 
nal, the following will appear: 
<[l234567890-_r\ >qwertyuiop@ asdfghjkl;: zxcvbnm,./ 
^1234567890—^ > V ;« * J 

<{!"#$%&'() 0~ >QWERTYUIOP^ ASDFGHJKL+* ZXCVBNM,.? 

< i"#*X& # =- >£AA£etf«pren ae8*r*it P x+* nwenu..' 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



Jfo 
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NAME 

SYNOPSIS 

DESCRIPTION 



logging in and logging out 



UNIX must be called from an appropriate terminal. 
UNIX supports ASCII terminals typified by the 
Teletype M37, the GE Terminet 300, the Memorex 
1240, and various graphical terminals on the one 
hand, and IBM 2741 -type terminals on the other. 

Not all installations support all these termi- 
nals. Often the M33/35 Teletype is supported 
instead of the 2741. Depending on the hardware 
installed, most terminals operating at 110, 
134.5, 150, or 300 baud can be accommodated. 

To use UNIX,, it is also necessary to have a valid 
UNIX user ID and (if desired) password. These 
may be obtained, together with the telephone 
number, from the system administrators. 

The same telephone number serves terminals 
operating at all the standard speeds. The dis- 
cussion below applies when the standard speeds of 
134.5 (2741 's) 150 (TTY 37' s) and 300 (Terminet 
300' s) are available. 

When a connection is established via aJ50-baud 
terminal (e.g. TTY 37) UNIX types out login: ; 
you respond with your user name, and, if request- 
ed, with a password. (The printer is turned off 
while you type the password.) If the login was 
successful, the "§" character is typed by the 
Shell to indicate login is complete and commands 
may be issued. A message of the day may be typed 
if there are any announcements. Also, if there 
is a file called "mailbox", you are notified that 
someone has sent you mail. (See the mail com- 
mand. ) 

From a 300-baud terminal, the procedure is 
slightly different. Such terminals often have a 
full-duplex switch, which should be turned on (or 
conversely, half-duplex should be turned off). 
When a connection with UNIX is established, a few 
garbage characters are typed (these are the 

login:" message at the wrong speed). You should 
depress the "break" key; this is a speed- 
independent signal to UNIX that a 300-baud termx- 
nal is in use. It will type login: (at the 
correct speed this time) and from then on the 
procedure is the same as described above. 

From a 2741 , no message will appear. After the 
telephone connection is established, press the 
"ATTN" button. UNIX should type login: as 
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LOGIN, LOGOUT (VIl) 

described above. If the greeting does not appear 
after a few seconds, hang up and try again; some- 
thing has gone wrong. If a password is required, 
the printer cannot be turned off, so it will 
appear on the paper when you type it. 

For more information, consult getty ( VII ), which 
discusses the login sequence in more detail, ana 
ttyO(IV), which discusses typewriter I/O. 

Loqqing out is simple by comparison (in fact, 
sometimes too simple). Simply generate an end- 
of-file at Shell level by using the EOT 
character; the "login: message will appear again 
to indicate that you may log in again. 

It is also possible to log out simply by hanging 

up the terminal; this simulates an end-of-fxle on 

the typewriter. 

/etc/motd may contain a message-of-the-day. 

in it (VII), getty(VIl), ttyO(IV) 



Hanging up on programs which never read the type- 
writer or which ignore end-of -files is very 
dangerous; in the worst cases, the programs can 
only be halted by restarting the system. 

ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



msh — mini-shell 



msh is a heavily simplified version of the Shell. 
It~reads one line from the standard input file, 
interprets it as a command, and calls the com- 
mand. 

The mini-shell supports few of the advanced 
features of the Shell; none of the following 
characters is special: 

> < $ \ ; & 

However, "•", "[", and "?" are recognized and 
qlob is called. The main use of msh is to pro- 
vide" a command-executing facility for various 
interactive sub-systems. 

found in /etc/msh 

sh, glob 



ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



tabs — tab stop set 

cat /usr/pub/tabs 

When printed on a suitable terminal, this file 
will set tab stops at columns 8, 16, 24, 32, .... 
Suitable terminals include the Teletype model 37 
and the GE TermiNet 300. 

These tabs stop settings are desirable because 
UNIX assumes them in calculating delays. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



ken 
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